---
title: "Get a supplier"
method: GET
path: "/api/v1/iqbooks/organisations/{organisationId}/suppliers/{id}"
tags: ["IQ Books — Contacts"]
---

# Get a supplier

`GET /api/v1/iqbooks/organisations/{organisationId}/suppliers/{id}`

## Request

- Base URL: `https://api.reconcileiq.com`
- URL: `https://api.reconcileiq.com/api/v1/iqbooks/organisations/{organisationId}/suppliers/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `organisationId` integer, required
- `id` integer, required

## Response `200`

A single contact.

- object
  - `data` Contact, required
    - `id` integer
    - `organisation_id` integer
    - `name` string
    - `email` string, nullable
    - `phone` string, nullable
    - `address_line1` string, nullable
    - `address_line2` string, nullable
    - `address_city` string, nullable
    - `address_postcode` string, nullable
    - `address_country` string, nullable
    - `vat_number` string, nullable
    - `default_payment_terms_days` integer, nullable
    - `default_currency_code` string, nullable
    - `notes` string, nullable
    - `outstanding_amount` number: Decimal major units, present on list responses that include it.
    - `invoice_count` integer
    - `archived` boolean
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but the key lacks the required scope.
- `404`: Resource not found, or not visible to the caller (no existence leak).

---

[API](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api.md) · [All operations](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api/revisions/5401beef8653?raw)
