# Suppliers

Retrieve supplier records for a given consent.

## List suppliers

> Retrieves a paginated list of suppliers for the specified consent.\
> \
> \*\*System support\*\*\
> \
> \| System | Status |\
> \|---|---|\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/fortnox\\_20\\_20.svg>" alt="Fortnox" width="20" height="20" style="vertical-align:middle" /> Fortnox | 🔧 Under development / beta release |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/bjorn-lunden\\_20\\_20.svg>" alt="Bjorn Lunden" width="20" height="20" style="vertical-align:middle" /> Bjorn Lunden | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/spiris\\_20\\_20.svg>" alt="Spiris" width="20" height="20" style="vertical-align:middle" /> Spiris | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/tripletex\\_20\\_20.svg>" alt="Tripletex" width="20" height="20" style="vertical-align:middle" /> Tripletex | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-economic\\_20\\_20.svg>" alt="Visma e-conomic" width="20" height="20" style="vertical-align:middle" /> Visma e-conomic | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/billy\\_20\\_20.svg>" alt="Billy" width="20" height="20" style="vertical-align:middle" /> Billy | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-dinero\\_20\\_20.svg>" alt="Visma Dinero" width="20" height="20" style="vertical-align:middle" /> Visma Dinero | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/finago-procountor\\_20\\_20.png>" alt="Procountor" width="20" height="20" style="vertical-align:middle" /> Procountor | 🔧 Under development / beta release |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-netvisor\\_20\\_20.svg>" alt="Visma Netvisor" width="20" height="20" style="vertical-align:middle" /> Visma Netvisor | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/business-central\\_20\\_20.svg>" alt="Microsoft Business Central" width="20" height="20" style="vertical-align:middle" /> Microsoft Business Central | ✅ Supported |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/exact-online\\_20\\_20.svg>" alt="Exact Online" width="20" height="20" style="vertical-align:middle" /> Exact Online | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/quickbooks\\_20\\_20.png>" alt="QuickBooks" width="20" height="20" style="vertical-align:middle" /> QuickBooks | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/xero\\_20\\_20.svg>" alt="Xero" width="20" height="20" style="vertical-align:middle" /> Xero | 🔧 Under development / beta release |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/bokio\\_20\\_20.svg>" alt="Bokio" width="20" height="20" style="vertical-align:middle" /> Bokio | 📞 Not supported / contact us |

```json
{"openapi":"3.1.1","info":{"title":"Accounting API","version":"v1"},"tags":[{"name":"Suppliers","description":"Retrieve supplier records for a given consent."}],"servers":[{"url":"https://apione.zwapgrid.com/accounting"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Use the API key to access all API endpoints.","name":"x-api-key","in":"header"}},"schemas":{"SupplierDtoPagedResultDto":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/PagedResultMetadataDto"},"data":{"type":["null","array"],"items":{"$ref":"#/components/schemas/SupplierDto"},"description":"Collection of items in the current page."}},"additionalProperties":false,"description":"Represents a paginated result containing metadata and a collection of items."},"PagedResultMetadataDto":{"type":"object","properties":{"totalResources":{"type":["null","integer"],"description":"Total number of resources across all pages.","format":"int32"},"totalPages":{"type":["null","integer"],"description":"Total number of pages available.","format":"int32"},"currentPage":{"type":"integer","description":"The current page number.","format":"int32"}},"additionalProperties":false,"description":"Represents pagination metadata for a paged result set."},"SupplierDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier for the supplier."},"customerAssignedAccountId":{"$ref":"#/components/schemas/IdentifierDto"},"party":{"$ref":"#/components/schemas/PartyDto"},"deliveryAddresses":{"type":["null","array"],"items":{"$ref":"#/components/schemas/AddressDto"},"description":"Collection of delivery addresses for the supplier."},"description":{"$ref":"#/components/schemas/NoteDto"},"financialDimensions":{"type":["null","array"],"items":{"$ref":"#/components/schemas/FinancialDimensionDto"},"description":"Collection of financial dimensions assigned to the supplier."},"active":{"type":["null","boolean"],"description":"Indicates whether the supplier is active."},"currency":{"type":["null","string"],"description":"Currency code associated with the supplier."},"paymentMeans":{"type":["null","array"],"items":{"$ref":"#/components/schemas/SupplierPaymentMeansDto"},"description":"Collection of payment means for the supplier."}},"additionalProperties":false,"description":"Represents a supplier entity in the accounting system."},"IdentifierDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Legal identifier."},"schemeId":{"type":["null","string"],"description":"Legal identifier scheme (e.g. SE:ORGNR)."}},"additionalProperties":false,"description":"Represents a legal identifier with an associated scheme."},"PartyDto":{"type":"object","properties":{"partyIdentification":{"type":["null","array"],"items":{"$ref":"#/components/schemas/IdentifierDto"},"description":"Collection of identifiers for the party."},"partyName":{"$ref":"#/components/schemas/PartyNameDto"},"postalAddress":{"$ref":"#/components/schemas/AddressDto"},"partyLegalEntity":{"$ref":"#/components/schemas/PartyLegalEntityDto"},"contact":{"$ref":"#/components/schemas/ContactDto"},"endpointId":{"$ref":"#/components/schemas/IdentifierDto"}},"additionalProperties":false,"description":"Represents a party (organization or individual) involved in a transaction."},"PartyNameDto":{"type":"object","properties":{"name":{"type":["null","string"],"description":"Name of the party."},"languageId":{"type":["null","string"],"description":"ISO 639-2 three-letter language code for the associated text, for example `ENG`, `SWE`, `DAN`, or `FIN`. Omit this value when the source system does not provide a language."}},"additionalProperties":false,"description":"Represents the name of a party with an optional language identifier."},"AddressDto":{"type":"object","properties":{"buildingNumber":{"type":["null","string"],"description":"Building number of the address."},"streetName":{"type":["null","string"],"description":"Primary street name."},"additionalStreetName":{"type":["null","string"],"description":"Secondary street name or additional address line."},"cityName":{"type":["null","string"],"description":"City or locality name."},"postalZone":{"type":["null","string"],"description":"Postal or ZIP code."},"country":{"$ref":"#/components/schemas/CountryDto"}},"additionalProperties":false,"description":"Represents a postal address."},"CountryDto":{"type":"object","properties":{"identificationCode":{"type":["null","string"],"description":"ISO 3166-1 alpha-2 country code."},"name":{"type":["null","string"],"description":"Country name."}},"additionalProperties":false,"description":"Represents a country with its identification code and name."},"PartyLegalEntityDto":{"type":"object","properties":{"registrationName":{"type":["null","string"],"description":"Registered legal name of the entity."},"companyId":{"$ref":"#/components/schemas/IdentifierDto"}},"additionalProperties":false,"description":"Represents the legal entity information of a party."},"ContactDto":{"type":"object","properties":{"name":{"type":["null","string"],"description":"Contact person name."},"telephone":{"type":["null","string"],"description":"Primary telephone number."},"email":{"type":["null","string"],"description":"Primary email address."},"secondaryEmail":{"type":["null","string"],"description":"Secondary email address."}},"additionalProperties":false,"description":"Represents contact information for a party."},"NoteDto":{"type":"object","properties":{"text":{"type":["null","string"],"description":"Content of the note."},"languageId":{"type":["null","string"],"description":"ISO 639-2 three-letter language code for the associated text, for example `ENG`, `SWE`, `DAN`, or `FIN`. Omit this value when the source system does not provide a language."}},"additionalProperties":false,"description":"Represents a textual note with an optional language identifier."},"FinancialDimensionDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier for the financial dimension."},"reference":{"type":["null","string"],"description":"Reference code for the financial dimension."},"type":{"type":["null","string"],"description":"Type or code of the financial dimension as exposed by the connected accounting system.\n\nKnown values currently emitted by supported connectors include:\n\n- businessGroup\n- campaign\n- costBearer\n- costCode\n- costUnit\n- customerGroup\n- department\n- employee\n- product\n- project\n- purchaser\n- salesPerson\n- salesRegion\n- supplierGroup\n\nSome connectors can also return additional system-specific dimension codes (for example custom Business Central dimension codes)."},"name":{"type":["null","string"],"description":"Display name of the financial dimension."},"description":{"type":["null","string"],"description":"Description of the financial dimension."},"isActive":{"type":["null","boolean"],"description":"Indicates whether the financial dimension is active."}},"additionalProperties":false,"description":"Represents a financial dimension used to assign granularity to financial reports (e.g. cost center, project)."},"SupplierPaymentMeansDto":{"type":"object","properties":{"paymentChannelCode":{"type":["null","string"],"description":"Code identifying the payment channel."},"payeeFinancialAccounts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/PayeeFinancialAccountDto"},"description":"Collection of payee financial accounts. Obsolete: use FinancialAccount instead. (Deprecated: Use PayeeFinancialAccount instead)","deprecated":true},"payeeFinancialAccount":{"type":["null","string"],"description":"Payee financial account identifier. Obsolete: use FinancialAccount.Id instead. (Deprecated: Use FinancialAccount.Id instead)","deprecated":true},"financialAccount":{"$ref":"#/components/schemas/FinancialAccountDto"}},"additionalProperties":false,"description":"Represents payment means associated with a supplier."},"PayeeFinancialAccountDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier for the financial account."},"financialInstitution":{"type":["null","string"],"description":"Name or identifier of the financial institution."}},"additionalProperties":false,"description":"Represents a payee's financial account details."},"FinancialAccountDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier for the financial account."},"financialInstitution":{"type":["null","string"],"description":"Name or identifier of the financial institution."}},"additionalProperties":false,"description":"Represents a financial account used for payments."},"ProblemDetails":{"type":"object","properties":{"type":{"type":["null","string"]},"title":{"type":["null","string"]},"status":{"type":["null","integer"],"format":"int32"},"detail":{"type":["null","string"]},"instance":{"type":["null","string"]}},"additionalProperties":{}}}},"paths":{"/api/v1/consents/{consentId}/suppliers":{"get":{"tags":["Suppliers"],"summary":"List suppliers","description":"Retrieves a paginated list of suppliers for the specified consent.\n\n**System support**\n\n| System | Status |\n|---|---|\n| <img src=\"https://clients.zwapgrid.com/assets/logos/fortnox_20_20.svg\" alt=\"Fortnox\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Fortnox | 🔧 Under development / beta release |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/bjorn-lunden_20_20.svg\" alt=\"Bjorn Lunden\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Bjorn Lunden | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/spiris_20_20.svg\" alt=\"Spiris\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Spiris | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/tripletex_20_20.svg\" alt=\"Tripletex\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Tripletex | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-economic_20_20.svg\" alt=\"Visma e-conomic\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma e-conomic | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/billy_20_20.svg\" alt=\"Billy\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Billy | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-dinero_20_20.svg\" alt=\"Visma Dinero\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma Dinero | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/finago-procountor_20_20.png\" alt=\"Procountor\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Procountor | 🔧 Under development / beta release |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-netvisor_20_20.svg\" alt=\"Visma Netvisor\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma Netvisor | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/business-central_20_20.svg\" alt=\"Microsoft Business Central\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Microsoft Business Central | ✅ Supported |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/exact-online_20_20.svg\" alt=\"Exact Online\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Exact Online | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/quickbooks_20_20.png\" alt=\"QuickBooks\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> QuickBooks | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/xero_20_20.svg\" alt=\"Xero\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Xero | 🔧 Under development / beta release |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/bokio_20_20.svg\" alt=\"Bokio\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Bokio | 📞 Not supported / contact us |","operationId":"ListSuppliers","parameters":[{"name":"consentId","in":"path","description":"Identifier of the consent representing the connection to the accounting system.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Count","in":"query","description":"Number of records to return per page. Range: 1-100.","schema":{"maximum":100,"minimum":1,"type":"integer","format":"int32"}},{"name":"CurrentPage","in":"query","description":"Page number to return. Must be 1 or greater.","schema":{"maximum":2147483647,"minimum":1,"type":"integer","format":"int32"}},{"name":"x-correlation-id","in":"header","description":"Unique identifier used to correlate and trace this request.","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Returns a paginated list of suppliers for the specified consent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierDtoPagedResultDto"}}}},"401":{"description":"Missing or invalid authentication credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"Not authorized to access this resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"501":{"description":"This operation is not supported by the connected accounting system.","content":{"application/json":{}}}}}}}}
```

## Get a supplier by ID

> Retrieves a single supplier by its identifier.\
> \
> \*\*System support\*\*\
> \
> \| System | Status |\
> \|---|---|\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/fortnox\\_20\\_20.svg>" alt="Fortnox" width="20" height="20" style="vertical-align:middle" /> Fortnox | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/bjorn-lunden\\_20\\_20.svg>" alt="Bjorn Lunden" width="20" height="20" style="vertical-align:middle" /> Bjorn Lunden | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/spiris\\_20\\_20.svg>" alt="Spiris" width="20" height="20" style="vertical-align:middle" /> Spiris | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/tripletex\\_20\\_20.svg>" alt="Tripletex" width="20" height="20" style="vertical-align:middle" /> Tripletex | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-economic\\_20\\_20.svg>" alt="Visma e-conomic" width="20" height="20" style="vertical-align:middle" /> Visma e-conomic | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/billy\\_20\\_20.svg>" alt="Billy" width="20" height="20" style="vertical-align:middle" /> Billy | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-dinero\\_20\\_20.svg>" alt="Visma Dinero" width="20" height="20" style="vertical-align:middle" /> Visma Dinero | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/finago-procountor\\_20\\_20.png>" alt="Procountor" width="20" height="20" style="vertical-align:middle" /> Procountor | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/visma-netvisor\\_20\\_20.svg>" alt="Visma Netvisor" width="20" height="20" style="vertical-align:middle" /> Visma Netvisor | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/business-central\\_20\\_20.svg>" alt="Microsoft Business Central" width="20" height="20" style="vertical-align:middle" /> Microsoft Business Central | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/exact-online\\_20\\_20.svg>" alt="Exact Online" width="20" height="20" style="vertical-align:middle" /> Exact Online | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/quickbooks\\_20\\_20.png>" alt="QuickBooks" width="20" height="20" style="vertical-align:middle" /> QuickBooks | 📞 Not supported / contact us |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/xero\\_20\\_20.svg>" alt="Xero" width="20" height="20" style="vertical-align:middle" /> Xero | 🔧 Under development / beta release |\
> \| \<img src="<https://clients.zwapgrid.com/assets/logos/bokio\\_20\\_20.svg>" alt="Bokio" width="20" height="20" style="vertical-align:middle" /> Bokio | 📞 Not supported / contact us |

```json
{"openapi":"3.1.1","info":{"title":"Accounting API","version":"v1"},"tags":[{"name":"Suppliers","description":"Retrieve supplier records for a given consent."}],"servers":[{"url":"https://apione.zwapgrid.com/accounting"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Use the API key to access all API endpoints.","name":"x-api-key","in":"header"}},"schemas":{"SupplierDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier for the supplier."},"customerAssignedAccountId":{"$ref":"#/components/schemas/IdentifierDto"},"party":{"$ref":"#/components/schemas/PartyDto"},"deliveryAddresses":{"type":["null","array"],"items":{"$ref":"#/components/schemas/AddressDto"},"description":"Collection of delivery addresses for the supplier."},"description":{"$ref":"#/components/schemas/NoteDto"},"financialDimensions":{"type":["null","array"],"items":{"$ref":"#/components/schemas/FinancialDimensionDto"},"description":"Collection of financial dimensions assigned to the supplier."},"active":{"type":["null","boolean"],"description":"Indicates whether the supplier is active."},"currency":{"type":["null","string"],"description":"Currency code associated with the supplier."},"paymentMeans":{"type":["null","array"],"items":{"$ref":"#/components/schemas/SupplierPaymentMeansDto"},"description":"Collection of payment means for the supplier."}},"additionalProperties":false,"description":"Represents a supplier entity in the accounting system."},"IdentifierDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Legal identifier."},"schemeId":{"type":["null","string"],"description":"Legal identifier scheme (e.g. SE:ORGNR)."}},"additionalProperties":false,"description":"Represents a legal identifier with an associated scheme."},"PartyDto":{"type":"object","properties":{"partyIdentification":{"type":["null","array"],"items":{"$ref":"#/components/schemas/IdentifierDto"},"description":"Collection of identifiers for the party."},"partyName":{"$ref":"#/components/schemas/PartyNameDto"},"postalAddress":{"$ref":"#/components/schemas/AddressDto"},"partyLegalEntity":{"$ref":"#/components/schemas/PartyLegalEntityDto"},"contact":{"$ref":"#/components/schemas/ContactDto"},"endpointId":{"$ref":"#/components/schemas/IdentifierDto"}},"additionalProperties":false,"description":"Represents a party (organization or individual) involved in a transaction."},"PartyNameDto":{"type":"object","properties":{"name":{"type":["null","string"],"description":"Name of the party."},"languageId":{"type":["null","string"],"description":"ISO 639-2 three-letter language code for the associated text, for example `ENG`, `SWE`, `DAN`, or `FIN`. Omit this value when the source system does not provide a language."}},"additionalProperties":false,"description":"Represents the name of a party with an optional language identifier."},"AddressDto":{"type":"object","properties":{"buildingNumber":{"type":["null","string"],"description":"Building number of the address."},"streetName":{"type":["null","string"],"description":"Primary street name."},"additionalStreetName":{"type":["null","string"],"description":"Secondary street name or additional address line."},"cityName":{"type":["null","string"],"description":"City or locality name."},"postalZone":{"type":["null","string"],"description":"Postal or ZIP code."},"country":{"$ref":"#/components/schemas/CountryDto"}},"additionalProperties":false,"description":"Represents a postal address."},"CountryDto":{"type":"object","properties":{"identificationCode":{"type":["null","string"],"description":"ISO 3166-1 alpha-2 country code."},"name":{"type":["null","string"],"description":"Country name."}},"additionalProperties":false,"description":"Represents a country with its identification code and name."},"PartyLegalEntityDto":{"type":"object","properties":{"registrationName":{"type":["null","string"],"description":"Registered legal name of the entity."},"companyId":{"$ref":"#/components/schemas/IdentifierDto"}},"additionalProperties":false,"description":"Represents the legal entity information of a party."},"ContactDto":{"type":"object","properties":{"name":{"type":["null","string"],"description":"Contact person name."},"telephone":{"type":["null","string"],"description":"Primary telephone number."},"email":{"type":["null","string"],"description":"Primary email address."},"secondaryEmail":{"type":["null","string"],"description":"Secondary email address."}},"additionalProperties":false,"description":"Represents contact information for a party."},"NoteDto":{"type":"object","properties":{"text":{"type":["null","string"],"description":"Content of the note."},"languageId":{"type":["null","string"],"description":"ISO 639-2 three-letter language code for the associated text, for example `ENG`, `SWE`, `DAN`, or `FIN`. Omit this value when the source system does not provide a language."}},"additionalProperties":false,"description":"Represents a textual note with an optional language identifier."},"FinancialDimensionDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier for the financial dimension."},"reference":{"type":["null","string"],"description":"Reference code for the financial dimension."},"type":{"type":["null","string"],"description":"Type or code of the financial dimension as exposed by the connected accounting system.\n\nKnown values currently emitted by supported connectors include:\n\n- businessGroup\n- campaign\n- costBearer\n- costCode\n- costUnit\n- customerGroup\n- department\n- employee\n- product\n- project\n- purchaser\n- salesPerson\n- salesRegion\n- supplierGroup\n\nSome connectors can also return additional system-specific dimension codes (for example custom Business Central dimension codes)."},"name":{"type":["null","string"],"description":"Display name of the financial dimension."},"description":{"type":["null","string"],"description":"Description of the financial dimension."},"isActive":{"type":["null","boolean"],"description":"Indicates whether the financial dimension is active."}},"additionalProperties":false,"description":"Represents a financial dimension used to assign granularity to financial reports (e.g. cost center, project)."},"SupplierPaymentMeansDto":{"type":"object","properties":{"paymentChannelCode":{"type":["null","string"],"description":"Code identifying the payment channel."},"payeeFinancialAccounts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/PayeeFinancialAccountDto"},"description":"Collection of payee financial accounts. Obsolete: use FinancialAccount instead. (Deprecated: Use PayeeFinancialAccount instead)","deprecated":true},"payeeFinancialAccount":{"type":["null","string"],"description":"Payee financial account identifier. Obsolete: use FinancialAccount.Id instead. (Deprecated: Use FinancialAccount.Id instead)","deprecated":true},"financialAccount":{"$ref":"#/components/schemas/FinancialAccountDto"}},"additionalProperties":false,"description":"Represents payment means associated with a supplier."},"PayeeFinancialAccountDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier for the financial account."},"financialInstitution":{"type":["null","string"],"description":"Name or identifier of the financial institution."}},"additionalProperties":false,"description":"Represents a payee's financial account details."},"FinancialAccountDto":{"type":"object","properties":{"id":{"type":["null","string"],"description":"Unique identifier for the financial account."},"financialInstitution":{"type":["null","string"],"description":"Name or identifier of the financial institution."}},"additionalProperties":false,"description":"Represents a financial account used for payments."},"ProblemDetails":{"type":"object","properties":{"type":{"type":["null","string"]},"title":{"type":["null","string"]},"status":{"type":["null","integer"],"format":"int32"},"detail":{"type":["null","string"]},"instance":{"type":["null","string"]}},"additionalProperties":{}}}},"paths":{"/api/v1/consents/{consentId}/suppliers/{supplierId}":{"get":{"tags":["Suppliers"],"summary":"Get a supplier by ID","description":"Retrieves a single supplier by its identifier.\n\n**System support**\n\n| System | Status |\n|---|---|\n| <img src=\"https://clients.zwapgrid.com/assets/logos/fortnox_20_20.svg\" alt=\"Fortnox\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Fortnox | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/bjorn-lunden_20_20.svg\" alt=\"Bjorn Lunden\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Bjorn Lunden | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/spiris_20_20.svg\" alt=\"Spiris\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Spiris | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/tripletex_20_20.svg\" alt=\"Tripletex\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Tripletex | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-economic_20_20.svg\" alt=\"Visma e-conomic\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma e-conomic | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/billy_20_20.svg\" alt=\"Billy\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Billy | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-dinero_20_20.svg\" alt=\"Visma Dinero\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma Dinero | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/finago-procountor_20_20.png\" alt=\"Procountor\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Procountor | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/visma-netvisor_20_20.svg\" alt=\"Visma Netvisor\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Visma Netvisor | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/business-central_20_20.svg\" alt=\"Microsoft Business Central\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Microsoft Business Central | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/exact-online_20_20.svg\" alt=\"Exact Online\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Exact Online | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/quickbooks_20_20.png\" alt=\"QuickBooks\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> QuickBooks | 📞 Not supported / contact us |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/xero_20_20.svg\" alt=\"Xero\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Xero | 🔧 Under development / beta release |\n| <img src=\"https://clients.zwapgrid.com/assets/logos/bokio_20_20.svg\" alt=\"Bokio\" width=\"20\" height=\"20\" style=\"vertical-align:middle\" /> Bokio | 📞 Not supported / contact us |","operationId":"GetSupplier","parameters":[{"name":"consentId","in":"path","description":"Identifier of the consent representing the connection to the accounting system.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"supplierId","in":"path","description":"Identifier of the supplier.","required":true,"schema":{"type":"string"}},{"name":"x-correlation-id","in":"header","description":"Unique identifier used to correlate and trace this request.","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Returns the requested supplier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierDto"}}}},"401":{"description":"Missing or invalid authentication credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"403":{"description":"Not authorized to access this resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"The requested supplier was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"501":{"description":"This operation is not supported by the connected accounting system.","content":{"application/json":{}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zwapgrid.com/api-guide/accounting-api-guide/suppliers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.