API Docs

Get Registration Types

Returns registration type enumerations with scheme agency IDs per OMN Tax Authority data dictionary. Each registration type includes a code (enum name) and scope (B2B or B2C). Used for SchemeAgencyId validation in party identification.

Use registration type codes when setting the scheme_agency_id field in party objects. The code identifies the type of registration document used for identification:

TIN (Tax Identification Number): For business entities registered in OMN
CID (Civil ID): For OMN residents (individuals)
PASNUM (Passport Number): For non-OMN residents (individuals)
OTHID (Other Id): For any other type of identification document not covered by the above categories
CR (Commercial Registration): For business entities registered in OMN
SZLN (Special Zone License Number): For business entities registered for special economic zones
ICID (Importer Customs Id): For business registered as importers in OMN

See the right panel for request, response, and JSON examples.

Request

# Base URL: https://api-sandbox.om.marmin.ai
# GET /api/codelist/registration-types

curl "https://api-sandbox.om.marmin.ai/api/codelist/registration-types"

Response

{
  "Commercial Registration": {
    "code": "CR",
    "scope": "B2B"
  },
  "Tax Identification Number": {
    "code": "TIN",
    "scope": "B2B"
  },
  "Passport Number": {
    "code": "PASNUM",
    "scope": "B2C"
  },
  "Special Zone License Number": {
    "code": "SZLN",
    "scope": "B2B"
  },
  "Importer Customs ID": {
    "code": "ICID",
    "scope": "B2B"
  },
  "Other Id": {
    "code": "OTHID",
    "scope": "B2C"
  },
  "Civil ID": {
    "code": "CID",
    "scope": "B2C"
  }
}