API Documentation
  • 👋Welcome
  • 🚦Getting Started
    • 🖥️Environment setup
    • 👨‍💻Sign up on portal
    • Subscribe to APIs
    • 📖Terminology
    • 🔐Authorization
  • 💲PRICING
    • Subscription
  • API Documentation
    • Companies API reference
      • Companyprofile
      • Information
      • Appointments
      • Directors
      • Employee verification
      • Registered office address
      • Filing history
    • BO API reference
      • Entity statement
      • Ownership or control statement
      • Natural person statement
      • Supporting documents
      • Individual document
  • Specification
  • USER GUIDE
    • For Data Consumers
Powered by GitBook
On this page

Was this helpful?

  1. API Documentation
  2. Companies API reference

Employee verification

Get details of an individual company director appointment by identity number

Last updated 7 months ago

Was this helpful?

Verify Directors

post

Get details of an individual company director appointment by identity number

Authorizations
Body
identity_numberstringRequired
Responses
200
Success
application/json
401
Unauthorised
application/json
post
POST /enterprise/v1/employee-verification HTTP/1.1
Host: cipc-apm-rs-dev.azure-api.net
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "identity_number": "8205305555555"
}
{
  "director_list": [
    {
      "identity_number": "string",
      "first_names": "string",
      "surname": "string",
      "initials": "string",
      "director_status": "string",
      "role": "string",
      "member_size_interest": 0,
      "member_contribution": 0,
      "appointment_date": "string",
      "resignation_date": "string",
      "enterprise_details": [
        {
          "enterprise_number": "string",
          "enterprise_name": "string",
          "enterprise_type": "string",
          "enterprise_status": "string",
          "registration_date": "string"
        }
      ]
    }
  ]
}