# Get a Supplier

Returns one Supplier (counterparty) of the Location.
The Business User needs Finances access in the Location; otherwise the request returns `403`.

Endpoint: GET /references/suppliers/{location_id}/{supplier_id}
Version: 1.0.0
Security: BearerPartnerUser

## Security:

  - `BearerPartnerUser` (unknown)
    http bearer Bearer {PartnerToken}, User {UserToken}

## Path parameters:

  - `location_id` (integer, required)
    Location ID

  - `supplier_id` (integer, required)
    Supplier ID

## Header parameters:

  - `Accept` (string, required)

  - `Content-Type` (string, required)

  - `Authorization` (string, required)
    Bearer {partner_token}, User {user_token}

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `success` (boolean)

  - `data` (object)
    A Supplier (counterparty) of the Location. Pass its `id` as `supplier_id` in financial
transactions and in inventory operations such as a product receipt.
    Example: {"id":4043,"company_id":4564,"type_id":0,"type":{"id":0,"title":"Legal entity"},"title":"Bloom Beauty Supply","inn":"1234567890","kpp":"123401001","phone":"+13155550142","email":"orders@example.com","…

  - `data.id` (integer)
    Supplier ID

  - `data.company_id` (integer)
    Location ID

  - `data.type_id` (integer)
    Legal form:
- `0` - Legal entity
- `1` - Individual entrepreneur
- `2` - Individual
    Enum: "0", "1", "2"

  - `data.type` (object)
    Legal form

  - `data.type.id` (integer)
    Legal form ID, same as `type_id`

  - `data.type.title` (string)
    Legal form name in the Business User's language

  - `data.title` (string)
    Supplier name

  - `data.inn` (string)
    Taxpayer identification number

  - `data.kpp` (string)
    Tax registration reason code (legal entities)

  - `data.phone` (string)
    Phone number

  - `data.email` (string)
    Email address

  - `data.contact` (string)
    Contact person

  - `data.comment` (string)
    Comment

  - `data.address` (string)
    Address

  - `meta` (array)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: Authentication needed.

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: Access denied.

## Response 404:

  - `404` (unknown)
    The Supplier does not exist, is deleted, or belongs to another Location

## Response 404 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object | array)
    Additional response data (empty object or empty array)
    Example: {}