Sign in

v1

latestOpenAPI 3.0.0Apache 2.02026-07-267057121.5 KB

Submit the OTP and obtain the Compliance CSID

Submit the One Time Password (OTP) generated in the ZATCA Fatoora portal.

post/apps/gov-sa/v1/entry/{silo_entry_id}/otp

Path parameters

silo_entry_idstring required
Example:5b45453c-cdd0-11ed-afa1-0242ac120002

ID of the org.Party silo entry being onboarded.

Request body

namestring required

Legal name of the supplier as registered with ZATCA.

invoice_type'1000' | '0100' | '1100' required

Which invoice transactions the CSID is requested for, encoded as ZATCA's 4-digit functionality map.

  • 1000 — standard tax invoices only.
  • 0100 — simplified invoices only.
  • 1100 — both standard and simplified invoices.
branch_namestring required

Name of the branch or organizational unit the certificate is issued for. In case of VAT Groups, this field should contain the 10-digit TIN number of the individual group member.

registered_addressstring required

Registered address of the supplier as recorded with ZATCA.

business_categorystring required

Business category or industry of the supplier.

otpstring required

6-digit One-Time Password generated in the ZATCA Fatoora portal for the registering device. Valid only for a short period.

Example request

{
  "name": "Acme Trading Co.",
  "invoice_type": "1100",
  "branch_name": "Head Office",
  "registered_address": "King Fahd Road, Riyadh 12211",
  "business_category": "Retail",
  "otp": "123456"
}

Response

OTP accepted, Compliance CSID obtained and credentials stored.