Get Supplier

GET

/api/v1/suppliers/:id

GET

/api/v1/suppliers/:id

$ curl https://api.getply.com/api/v1/suppliers/b2c3d4e5-f6a7-8901-bcde-f12345678901 \
>      -H "API_KEY: <apiKey>"

1 {
2   "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
3   "businessName": "Acme Supply Co.",
4   "additionalContacts": [
5     {
6       "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
7       "contactName": "Bob Nguyen",
8       "phoneNumber": "+15555550102",
9       "contactEmail": "bob.nguyen@acmesupply.com"
10     }
11   ],
12   "businessEmail": "orders@acmesupply.com",
13   "contactName": "Jane Smith",
14   "phoneNumber": "+15555550100",
15   "address": "123 Industrial Blvd",
16   "city": "Austin",
17   "state": "TX",
18   "zipCode": "78701",
19   "website": "https://acmesupply.com",
20   "note": "Net-30 payment terms",
21   "createdAt": "2025-06-01T08:00:00Z",
22   "updatedAt": "2026-02-10T10:00:00Z"
23 }

Returns a single supplier by ID, including all additional contacts.

Requires scope: suppliers:read

Authentication

API_KEYstring

API Key authentication via header

Path parameters

idUUIDRequired

Supplier ID.

Response

This endpoint returns an object.

idUUID

Unique identifier for the supplier.

businessNamestring

Display name of the supplier business.

additionalContactslist of objects

Additional contacts at this supplier. Empty list if none configured.

businessEmailstring

Primary email address for the supplier business.

contactNamestring

Name of the primary contact person at this supplier.

phoneNumberstring

Primary phone number for the supplier.

addressstring

Street address.

citystring

City.

statestring

State or province code (e.g. TX).

zipCodestring

Postal/ZIP code.

websitestring

Supplier website URL.

notestring

Internal notes about this supplier.

createdAtdatetime

ISO 8601 timestamp when the record was created.

updatedAtdatetime

ISO 8601 timestamp when the record was last updated.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error