DIdigitax
Suppliers

Get a business supplier

Retrieves a supplier associated with the authenticated business by their DigiTax supplier ID.

get/suppliers/{supplier_id}

Request

  • Base URL
    https://api.digitax.tech/ke/v2
  • Auth
    API key in header X-API-Key

Path parameters

supplier_idstring required

Supplier ID on DigiTax

Example:supplier_01JS16JDB2B5ESZ8HWJ3CBYP5Y

Response

Success

idstring required

The DigiTax ID of the supplier.

supplier_namestring required

The name of the supplier.

emailstring

The supplier's email address.

phonestring

The supplier's phone number.

supplier_tinstring required

The supplier's Tax Identification Number (TIN).

taxpayer_type'INDIVIDUAL' | 'BUSINESS' required

The type of taxpayer, derived from the TIN prefix - P is BUSINESS, all other prefixes are INDIVIDUAL.

status'PENDING' | 'FAILED' | 'COMPLETED'

Whether the supplier has been synced with KRA's eTIMS - PENDING until synced, then COMPLETED or FAILED.

Example response

{
  "id": "supplier_01JS16JDB2B5ESZ8HWJ3CBYP5Y",
  "supplier_name": "John Doe Inc",
  "email": "accounts@johndoeinc.com",
  "phone": "+254712345678",
  "supplier_tin": "P012345678P",
  "taxpayer_type": "INDIVIDUAL",
  "invoicing": {
    "reverse_invoice_type": "REGULAR",
    "reverse_invoice_authorisation": "IMPLICIT"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.