SubOrganizationDetail

idintegerrequired

Internal unique identifier of the sub-organization (system-generated)

Example: 5472

externalIdstringrequired

The identifier assigned by the API consumer

Possible values: <= 255 characters

Example: New-Sub-ORG-ID

namestringrequired

Official name of the sub-organization

Possible values: <= 255 characters

Example: ABCGH

typestringrequired

Classification of the sub-organization. Support O(Office) only

Possible values: [O]

Example: O

externalStatusstringrequired

Sub-organization status as defined by the external system or API consumer

Possible values: [active, inactive, awaiting approval, draft, suspended, blacklisted, closed]

Example: active

addressstringrequired

Street address of the sub-organization

Possible values: <= 255 characters

Example: A Street

citystring | nullnullablerequired

The city where the sub-organization is located

Possible values: <= 100 characters

Example: Kabul

provincestring | nullnullablerequired

The province or state where the sub-organization is located

Possible values: <= 100 characters

Example: Kabul Province

postalCodestring | nullnullablerequired

Postal or ZIP code of the sub-organization's address

Possible values: <= 20 characters

Example: 1001

countrystringrequired

Country where the sub-organization is located (ISO 3166-1 alpha-2 format)

Possible values: <= 2 characters, Value must match regular expression ^[A-Z]{2}$

Example: AF

maleEmployeesinteger | nullnullablerequired

Number of male employees reported by the sub-organization

Example: 123456

femaleEmployeesinteger | nullnullablerequired

Number of female employees reported by the sub-organization

Example: 1241

solutionsUsedstring[]required

List of solutions used by the sub-organization

Possible values: [Inspection, T&A, Lab Test]

Example: ["Inspection","T&A","Lab Test"]

phoneNumberstring | nullnullablerequired

The phone number of the sub-organization

Possible values: <= 50 characters

Example: +93-20-123-4567

createdAtstring<date-time>required

Timestamp when the sub-organization record was created (ISO 8601 format)

Possible values: Value must match regular expression ^\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d(\.\d{3})?Z$

Example: 2024-09-01T08:30:00Z

updatedAtstring<date-time>required

Timestamp when the sub-organization record was last updated (ISO 8601 format)

Possible values: Value must match regular expression ^\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d(\.\d{3})?Z$

Example: 2025-12-18T09:51:32Z

linkedOrganizations object[]required

List of organizations linked to this sub-organization

Array [

idintegerrequired

Internal unique identifier of the linked organization

Example: 5484

namestringrequired

Name of the linked organization

Possible values: <= 255 characters

Example: Test Local Org 1

]

contacts object[]required

List of primary contact persons for the sub-organization

Array [

firstNamestringrequired

First name of the contact person

Possible values: <= 100 characters

Example: Ahmed

lastNamestring

Last name of the contact person

Possible values: <= 100 characters

Example: Benali

emailstring<email>required

Email address of the contact person

Possible values: <= 255 characters

Example: [email protected]

phoneNumberstring

Phone number of the contact person

Possible values: <= 50 characters

Example: +213-555-123-456

rolestring

Job title or role of the contact person within the sub-organization, can refer from List Contact Roles API

Possible values: <= 100 characters

Example: Manager

]

location objectrequired

Location coordinates of the sub-organization

longitudenumber,null<double>nullable

Longitude of the sub-organization's location

Example: 3.0588

latitudenumber,null<double>nullable

Latitude of the sub-organization's location

Example: 36.7538

SubOrganizationDetail

{
  "id": 5472,
  "externalId": "New-Sub-ORG-ID",
  "name": "ABCGH",
  "type": "O",
  "externalStatus": "active",
  "address": "A Street",
  "city": "Kabul",
  "province": "Kabul Province",
  "postalCode": "1001",
  "country": "AF",
  "maleEmployees": 123456,
  "femaleEmployees": 1241,
  "solutionsUsed": [
    "Inspection",
    "T&A",
    "Lab Test"
  ],
  "phoneNumber": "+93-20-123-4567",
  "createdAt": "2024-09-01T08:30:00Z",
  "updatedAt": "2025-12-18T09:51:32Z",
  "linkedOrganizations": [
    {
      "id": 5484,
      "name": "Test Local Org 1"
    },
    {
      "id": 5189,
      "name": "Test Local Org 2"
    },
    {
      "id": 5203,
      "name": "Test Local Org 3"
    }
  ],
  "contacts": [
    {
      "firstName": "Ahmed",
      "lastName": "Benali",
      "email": "[email protected]",
      "phoneNumber": "+213-555-123-456",
      "role": "Manager"
    }
  ],
  "location": {
    "longitude": 3.0588,
    "latitude": 36.7538
  }
}