KRA Customs API

Check customs declaration statuses through the KRA developer.go.ke API. Look up import and export declarations, view assessment details, and track clearance progress.

Overview
Check Declaration Status
Declaration Statuses
Declaration Types
Status Codes

Overview

Required Scope

Scope	Description
`kra:checkers`	Customs declaration lookup (shared with other checkers)

Endpoint Summary

Method	Endpoint	KRA Path	Description
`POST`	`/api/kra/checkers/declaration`	`/checker/v1/simple/declaration`	Check customs declaration status

Check Declaration Status

Look up the status and details of a customs declaration by its declaration number.

Endpoint: POST /api/kra/checkers/declaration

Required Scope: kra:checkers

Request Body:

Field	Type	Required	Description
`DeclarationNo`	string	Yes	Customs declaration number

Request:

curl -X POST \
  https://yourtenant.salami.dgl.co.ke/api/kra/checkers/declaration \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "DeclarationNo": "2026ICD001234"
  }'

Success Response:

{
  "success": true,
  "data": {
    "DeclarationNo": "2026ICD001234",
    "DeclarationType": "IM4",
    "DeclarationStatus": "Released",
    "ImporterPIN": "P051234567A",
    "ImporterName": "ACME LIMITED",
    "AgentPIN": "B001122334C",
    "AgentName": "CLEARING AGENTS LTD",
    "PortOfEntry": "Mombasa",
    "PortCode": "KE-MBA",
    "DeclarationDate": "2026-03-10",
    "AssessedDate": "2026-03-11",
    "ReleasedDate": "2026-03-12",
    "CustomsValue": 5000000.00,
    "ImportDuty": 1250000.00,
    "VAT": 1000000.00,
    "ExciseDuty": 0,
    "RailwayDevelopmentLevy": 75000.00,
    "ImportDeclarationFee": 17500.00,
    "TotalAssessedDuty": 2342500.00,
    "TotalPaid": 2342500.00,
    "Currency": "KES",
    "CountryOfOrigin": "CN",
    "GoodsDescription": "Electronic Equipment"
  }
}

Not Found Response:

{
  "success": false,
  "message": "KRA API error: Declaration not found",
  "error": "kra_error"
}

Response Fields

Field	Type	Description
`DeclarationNo`	string	The declaration number queried
`DeclarationType`	string	Type code (see table below)
`DeclarationStatus`	string	Current status (see statuses below)
`ImporterPIN`	string	Importer's KRA PIN
`ImporterName`	string	Importer's registered name
`AgentPIN`	string	Clearing agent's KRA PIN
`AgentName`	string	Clearing agent's name
`PortOfEntry`	string	Entry port name
`PortCode`	string	Port code
`DeclarationDate`	string	Date of declaration
`AssessedDate`	string/null	Date duties were assessed
`ReleasedDate`	string/null	Date goods were released
`CustomsValue`	number	Declared customs value (KES)
`ImportDuty`	number	Import duty amount
`VAT`	number	VAT amount
`ExciseDuty`	number	Excise duty amount
`RailwayDevelopmentLevy`	number	RDL amount
`ImportDeclarationFee`	number	IDF fee
`TotalAssessedDuty`	number	Total assessed duties
`TotalPaid`	number	Total amount paid
`Currency`	string	Assessment currency
`CountryOfOrigin`	string	ISO country code of goods origin
`GoodsDescription`	string	Description of imported goods

Declaration Statuses

Status	Description
`Registered`	Declaration submitted and registered
`Under Assessment`	Being assessed by customs officers
`Assessed`	Duties have been calculated and assessed
`Queried`	Declaration has queries requiring resolution
`Amended`	Declaration has been amended
`Pending Payment`	Awaiting duty payment
`Paid`	All duties have been paid
`Under Examination`	Goods selected for physical examination
`Examined`	Physical examination completed
`Released`	Goods cleared and released from customs
`Cancelled`	Declaration cancelled
`Held`	Declaration held pending investigation
`Under Verification`	Post-clearance audit/verification in progress

Status Flow (Typical Import)

Registered
    |
    v
Under Assessment
    |
    v
Assessed
    |
    v
Pending Payment
    |
    v
Paid
    |
    v
Released (or Under Examination -> Examined -> Released)

Declaration Types

Code	Description	Direction
`IM4`	Home Consumption (standard import)	Import
`IM5`	Temporary Admission	Import
`IM7`	Warehousing	Import
`IM8`	Transit	Import
`EX1`	Direct Export	Export
`EX2`	Temporary Export	Export
`EX3`	Re-Export	Export
`TRA`	Transit Declaration	Transit
`WH`	Warehouse Declaration	Warehouse

Declaration Number Format

Declaration numbers typically follow this pattern:

YYYY + TYPE + SEQUENCE
Example: 2026ICD001234

Segment	Description	Example
`2026`	Year	2026
`ICD`	Entry type (ICD = Inland Container Depot)	ICD
`001234`	Sequence number	001234

Other common prefixes:

MBA -- Mombasa port
NRB -- Nairobi (JKIA)
ICD -- Inland Container Depot
KIS -- Kisumu port

Status Codes

Code	Description
`200`	Declaration found and returned
`401`	Invalid or missing Salami token
`403`	Token lacks `kra:checkers` scope
`404`	Declaration not found
`422`	Missing `DeclarationNo` field
`502`	KRA server error or timeout

Best Practices

Use exact declaration numbers -- Declaration numbers are case-sensitive
Handle not-found gracefully -- Some declarations may not be in the system yet
Track status changes -- Poll periodically if awaiting clearance
Verify before payment -- Check declaration status before making duty payments
Keep records -- Store declaration responses for audit and compliance

Salami Gateway