Setup with Serial Number

POST/api/v1/setup

Register a device serial number with Kenya Revenue Authority. Use POST /initialize instead for a combined setup and sync in one call.

Requires x-api-key

http://localhost:8100/api/v1/setup

Headers

Field	Type	Required	Description
x-api-key	string	Required	Your Ushuru API key
Content-Type	string	Required	Must be application/json

Request Body

Field	Type	Required	Description
deviceSerialNumber	string	Required	Physical serial number of the OSCU device being registered with Kenya Revenue Authority

Request

{
  "deviceSerialNumber": "SN-DEVICE-001"
}

Response

{
  "resultCd": "000",
  "resultMsg": "Success",
  "data": {
    "sdcId": "SDC12345678",
    "mrcNo": "MRC0001",
    "deviceStatus": "ACTIVE"
  }
}

curl -X POST http://localhost:8100/api/v1/setup \\
  -H "x-api-key: YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{"deviceSerialNumber": "SN-DEVICE-001"}'