Get a company
Fetch one company from your CRM by its ID, including its underlying business record, owner, group, relationship type, payment term, custom fields, licenses, locations, and computed outstanding balance.
Returns 404 if no company with that ID exists on your account, and 403 if your team restrictions hide it. A soft-deleted company is still returned here, with a non-null deleted_at. This read is served from a replica and is eventually consistent — a create or update made through the API can take up to 1 second to be reflected.
Required permission: companies_permissions_view.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
id*stringID of the company to fetch.
A single company
*/*- response
A single company relationship
data?A business in your network — a customer, a vendor, or both. Holds contact details, locations, licenses, and the terms you deal on.
curl -X GET 'https://app.distru.com/public/v1/companies/00000000-0000-0000-0000-000000000392'{ "data": { "category": "Retailer", "custom_data": [ { "id": 2364, "name": "Custom Field 47", "value": "Custom Value" } ], "default_email": "[email protected]", "default_payment_term": { "days": 15, "id": "00000000-0000-0000-0000-000000000424", "inserted_datetime": "2026-11-05T10:59:43.831450Z", "locked": false, "name": "Net 15", "time_of_day": "17:00:00", "updated_datetime": "2026-11-05T10:59:43.831450Z" }, "default_purchase_order_notes": null, "default_sales_order_notes": null, "deleted_at": null, "group": { "id": "00000000-0000-0000-0000-0000000002be", "name": "Comp Rel Group 24" }, "id": "00000000-0000-0000-0000-00000001ae41", "inserted_datetime": "2026-11-05T10:59:43.837428Z", "invoice_email": "[email protected]", "leaflink_brand_id": null, "leaflink_customer_id": null, "legal_business_name": "Legal Co", "licenses": [ { "active": true, "expiry_datetime": "2026-12-05T10:59:43.830012Z", "id": "00000000-0000-0000-0000-000000006cf3", "inserted_datetime": "2026-11-05T10:59:43.830056Z", "issue_datetime": "2026-11-05T10:59:43.830011Z", "license_number": "CDPH-00000129", "license_type": "Type 9 Non-Storefront" } ], "locations": [ { "address": "123 Fake Street, Beverly Hills, CA 90210, US", "company": { "id": "00000000-0000-0000-0000-00000001ae41", "name": "Company 1889", "updated_datetime": "2026-11-05T10:59:43.837428Z" }, "company_id": "00000000-0000-0000-0000-00000002c784", "id": "00000000-0000-0000-0000-000000011ff9", "license_id": null, "name": "Place 473" } ], "name": "Company 1889", "order_shipment_email": null, "outstanding_balance": "0", "outstanding_balance_threshold": null, "owner": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName6102 LastName6103", "id": "00000000-0000-0000-0000-00000003d9ea", "inserted_datetime": "2026-11-05T10:59:43.835264Z", "role": { "id": "00000000-0000-0000-0000-00000003f813", "name": "Admin 3238" }, "updated_datetime": "2026-11-05T10:59:43.835264Z" }, "owner_id": "00000000-0000-0000-0000-00000003d9ea", "past_due_balance": "0", "phone_number": null, "purchase_order_email": null, "qb_customer_id": null, "qb_vendor_id": null, "relationship_type": { "id": "00000000-0000-0000-0000-00000000052b", "name": "Supplier" }, "sales_order_email": "[email protected]", "tasks": [], "updated_datetime": "2026-11-05T10:59:43.837428Z", "website": null }}