---
title: "Returns information about a single Supplier. You may specify that Supplier's ledger balance should be calculated."
method: GET
path: "/v1/suppliers/{id}"
tags: ["Suppliers"]
---

# Returns information about a single Supplier. You may specify that Supplier's ledger balance should be calculated.

`GET /v1/suppliers/{id}`

## Path parameters

- `id` integer, required

## Query parameters

- `needBalance` boolean

## Response `200`

OK

- SupplierDto
  - `postponedAccounting` boolean
  - `internationalServices` boolean
  - `purchaseImporterSetting` PurchaseImporterSettingDto
    - `nominal` integer
    - `analysisCategory` integer
    - `vatCategory` string
  - `id` integer
  - `ownerTypeId` integer
  - `code` string
  - `accountName` string
  - `accountNumber` string
  - `authCode` string
  - `contact` string
  - `eFTReference` string
  - `email` string
  - `fax` string
  - `mobile` string
  - `name` string
  - `ourCode` string
  - `phone` string
  - `vatReg` string
  - `timestamp` string, byte
  - `address` string[]
  - `additionalEmails` string[]
  - `bank` EFTBankDto
    - `id` integer
    - `name` string
    - `branch` string
    - `sortCode` string
  - `vatAnalysisTypeId` integer
  - `vatType` integer
  - `ledgerBalance` number, double
  - `openingBalance` OwnerOpeningBalanceInPeriodsDto
    - `currentMonth` number, double
    - `oneMonthOld` number, double
    - `twoMonthsOld` number, double
    - `threeMonthsOld` number, double
  - `openingBalances` OwnerOpeningBalanceDto[]
    - `id` integer
    - `entryDate` string, date-time
    - `procDate` string, date-time
    - `reference` string
    - `timestamp` string, byte
    - `total` number, double
    - `totalVAT` number, double
    - `unpaid` number, double
    - `vatEntries` OwnerOpeningBalanceVatEntryDto[]
      - `vatRateId` integer
      - `amount` number, double
    - `isChanged` boolean
  - `businessIdentifierCode` string
  - `internationalBankAccountNumber` string
  - `salesRepId` integer

---

[API](https://skmtc.net/bigredcloud/apis/big-red-cloud-api.md) · [All operations](https://skmtc.net/bigredcloud/apis/big-red-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigredcloud/big-red-cloud-api/versions/1324a5ec638a/schema)