Moneybird logo
Moneybird API

Import mappings

Endpoint:https://moneybird.com/api/v2

With the move from the old Moneybird to the new Moneybird, all ids of entities in an administration have changed. Some API developers might have saved old ids in their database. In order for them to keep querying our API with the right ids, we have added an API for the import mappings. By querying the import mapping API, you can transform old ids to new ids in the new Moneybird. This should be a one-time conversion, this API will not be indefinitely available.

deprecated

Returns the import mapping for the given type and id

GET
https://moneybird.com/api/v2
/{administration_id}/import_mappings/{type}/{id}{format}

Returns a single mapping from the given type and id to a new id in the new MoneyBird. The given id can be both an old id or a new id, in both cases the correct mapping will be returned.

Can be one of financial_account, bank_mutation, contact, document_attachment, general_journal_document, identity, incoming_invoice, attachment, payment, history, invoice_attachment, transaction, ledger_account, tax_rate, product, print_invoice, recurring_template, invoice, invoice_workflow, estimate_workflow, document_style, bank_account_ledger_account_id, financial_statement, estimate, signature, estimate_attachment, payment_gateway, ledger_account_alternative, payment_to_link

Returns the import mapping for the given type and id › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • typestring · required
  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

Returns the import mapping for the given type and id › Responses

The import mapping for the given type and id

  • administration_idstring | integer · pattern: ^\d+$

    A unique record identifier of an administration

  • entity_typestring
  • old_idstring | integer · pattern: ^\d+$

    A unique record identifier

  • new_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

deprecated

List all import mappings for the given type

GET
https://moneybird.com/api/v2
/{administration_id}/import_mappings/{type}{format}

Returns a list of mappings from old ids to new ids for the given type.

Can be one of financial_account, bank_mutation, contact, document_attachment, general_journal_document, identity, incoming_invoice, attachment, payment, history, invoice_attachment, transaction, ledger_account, tax_rate, product, print_invoice, recurring_template, invoice, invoice_workflow, estimate_workflow, document_style, bank_account_ledger_account_id, financial_statement, estimate, signature, estimate_attachment, payment_gateway, ledger_account_alternative, payment_to_link

List all import mappings for the given type › path Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • typestring · required
  • formatstring · pattern: ^(.(json|xml))?$ · required

    The format in which the response is given, can be empty to use the default format

    Default: .json

List all import mappings for the given type › Responses

A list of import mappings for the given type

  • administration_idstring | integer · pattern: ^\d+$

    A unique record identifier of an administration

  • entity_typestring
  • old_idstring | integer · pattern: ^\d+$

    A unique record identifier

  • new_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

IdentitiesLedger accounts