Get a supplier
Header Parameters
Query Parameters
Comma-separated allow-list of top-level fields to return, e.g. ?fields=id,name. Narrows the response only; it cannot widen it, and ?expand= does nothing on this API.
Comma-separated list of top-level fields to leave out, e.g. ?omit=children.
Path Parameters
Company ID. Must be one of the IDs returned by GET /api/v2/companies/.
Row id. A row belonging to another company is 404 on every verb, never 403.
Response
The row. Soft-deleted rows are returned here too, with deleted set.
Response Attributes
Name shown to requesters, if it should differ from name.
Hidden from the catalogue in the UI. Unlike the in-app list, this API returns unlisted suppliers.
Your supplier number. Sortable via ?ordering=supplierNumber.
Supplier number in a third system, e.g. your ERP.
Your customer number with this supplier.
Language used for orders and emails to this supplier.
ENDEESFRFITRHUITISO 4217 code. null or "" when the supplier has none set, in which case the company currency applies.
EURUSDGBPSEKPLNCHFCZKHUFDKKRON... 3 other enums
Where orders are sent when orderViaEmail is true.
Text appended to every order.
Postal code.
Incoterm for deliveries from this supplier. null or "" when none is agreed.
EXWFCACPTCIPDAPDPUDDPFASFOBCFR... 2 other enums
Expected delivery time in days.
Decimal string, e.g. "1250.00".
Order value above which the responsible user is notified.
Percentage as a decimal string, e.g. "2.50".
Show child attributes
Inverts the category gate.
Show child attributes
Per-legal-entity overrides.
Show child attributes
Attachments. Read-only.
Show child attributes
Server-maintained supplier budgets. Read-only.
Show child attributes
Read-only. Part of the rule deciding which people see this supplier in the UI. Each …Allowed flag inverts its gate, so a write here could hide a supplier from everyone; they are readable so an integration can see the rules, and not writable so it cannot break them.
Show child attributes
Read-only. Part of the rule deciding which people see this supplier in the UI. Each …Allowed flag inverts its gate, so a write here could hide a supplier from everyone; they are readable so an integration can see the rules, and not writable so it cannot break them.
Read-only. Part of the rule deciding which people see this supplier in the UI. Each …Allowed flag inverts its gate, so a write here could hide a supplier from everyone; they are readable so an integration can see the rules, and not writable so it cannot break them.
Show child attributes
Read-only. Part of the rule deciding which people see this supplier in the UI. Each …Allowed flag inverts its gate, so a write here could hide a supplier from everyone; they are readable so an integration can see the rules, and not writable so it cannot break them.
Read-only. Part of the rule deciding which people see this supplier in the UI. Each …Allowed flag inverts its gate, so a write here could hide a supplier from everyone; they are readable so an integration can see the rules, and not writable so it cannot break them.
Show child attributes
Read-only. Part of the rule deciding which people see this supplier in the UI. Each …Allowed flag inverts its gate, so a write here could hide a supplier from everyone; they are readable so an integration can see the rules, and not writable so it cannot break them.
Read-only. Part of the rule deciding which people see this supplier in the UI. Each …Allowed flag inverts its gate, so a write here could hide a supplier from everyone; they are readable so an integration can see the rules, and not writable so it cannot break them. Role codes: O owner, MD managing director, AC accountant, BU buyer, AP approver, AL approver (limited), CO contract owner, AU API user, CR controller, NA news admin, AD auditor, LA legal-entity ...
OMDACBUAPALCOAUCRNA... 4 other enums
Show child attributes
Read-only. Part of the rule deciding which people see this supplier in the UI. Each …Allowed flag inverts its gate, so a write here could hide a supplier from everyone; they are readable so an integration can see the rules, and not writable so it cannot break them.
When the row was created.
When the row itself last changed.
null on a live row; the timestamp of the soft delete otherwise. Read-only everywhere.
Missing, invalid, or expired API key, or a session credential was used instead of an API key.
Response Attributes
validationErrorclientErrorserverError Show child attributes
Authenticated but not entitled: the key's user is not an active member of this company, the External API feature (or the resource's own feature) is not enabled for it, the key lacks the scope this verb needs, or a browser session was used.
Response Attributes
validationErrorclientErrorserverError Show child attributes
No such row for this company, including a row that belongs to another company, and a soft-deleted row you tried to write to. The API does not confirm whether the id exists elsewhere.
Response Attributes
validationErrorclientErrorserverError Show child attributes
Rate limit exceeded (60 requests per minute per API key). Retry after the number of seconds given in the message.
Response Attributes
validationErrorclientErrorserverError