Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Business

GET

https://api.zid.sa/v1/managers/account/store/business

Retrieves the KYC (Know Your Customer) verification details of the current store, including the Commercial Registration (CR) information and associated business details.

🔑Scopes

third_store_business_read - Read the store's business and legal data

Request

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.zid.sa/v1/managers/account/store/business' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en'

Responses

🟢200OK

application/json

Body

Example

{
  "status": "object",
  "business": {
    "store_business_data": {
      "civil_id": 1234567841,
      "business_place_status": "new",
      "has_branches": true,
      "branch_no": 1,
      "business_type": "individual",
      "business_corporate_name": "Osama",
      "employee_no": 6,
      "email": "os1987@yahoo.com",
      "commercial_name": "joud",
      "maroof_number": 5555,
      "is_maroof_checked": false,
      "is_freelance_checked": false,
      "commercial_register_certificate": "https://zid-testing-907587157081.s3.eu-west-1.amazonaws.com/3dfc16e6-ad19-4126-9c2a-5e4a7fb73051/ef3bc992-c9f6-4fdd-b40e-fca3214b974e.jpg",
      "maroof_certificate": "https://zid-testing-907587157081.s3.eu-west-1.amazonaws.com/3dfc16e6-ad19-4126-9c2a-5e4a7fb73051/2261687f-0ff4-4c0c-84ee-eb05f6e63540.png",
      "civil_id_image": "https://zid-testing-907587157081.s3.eu-west-1.amazonaws.com/3dfc16e6-ad19-4126-9c2a-5e4a7fb73051/ccc73525-2647-40a1-9239-2fb1df54ff72.png"
    },
    "commercial_registration_number": null,
    "commercial_registration_number_activation": null
  },
  "message": {
    "type": "object",
    "code": null,
    "name": null,
    "description": null
  }
}

🟠403Forbidden

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server error

Modified at 2026-04-20 10:53:17

Operations

Orders