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

Appointments

Get details of an individual company director appointment

Was this helpful?

Company director appointment

post

Get details of an individual company director appointment

Authorizations
Body
enterprise_numberstringRequired
identity_numberstringRequired
Responses
200
Read Director Profile
application/json
401
Unauthorised
application/json
post
POST /enterprise/v1/appointments 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: 72

{
  "enterprise_number": "2020/939681/07",
  "identity_number": "8205300000089"
}
{
  "appointment": [
    {
      "first_names": "string",
      "surname": "string",
      "initials": "string",
      "identity_number": "string",
      "date_of_birth": "1997-06-11",
      "director_status": "string",
      "enterprise_number": "string",
      "enterprise_name": "string",
      "director_type": "string",
      "designation": "string",
      "enterprise_type": "string",
      "enterprise_status": "string",
      "registration_date": "27-01-2021",
      "appointment_date": "27-01-2021",
      "resignation_date": "27-01-2023",
      "country_code": "string",
      "member_size_interest": 0,
      "member_contribution": 0,
      "residential_address_1": "string",
      "residential_address_2": "string",
      "residential_address_3": "string",
      "residential_address_4": "string",
      "residential_postal_code": "string"
    }
  ]
}