Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-26401961.7 KB
Suppliers

Get a business supplier

Retrieves information about a supplier given their ID on DigiTax

get/suppliers/{supplier_id}

Path parameters

supplier_idstring required

Supplier ID on DigiTax

Example:supplier_01JS16JDB2B5ESZ8HWJ3CBYP5Y

Response

Success

idstring required

Supplier ID

supplier_namestring required

Supplier Name

emailstring

Supplier Email

phonestring

Supplier Phone Number

supplier_tinstring required

Supplier Tax Identification Number (TIN)

taxpayer_type'INDIVIDUAL' | 'BUSINESS' required

Taxpayer Type

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

status against KRA

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"
  }
}