Contacts

Endpointhttps://api.most.ac/v1

Manage contacts attached to a client (registrant, admin, tech, billing).

List client contacts

GET

https://api.most.ac/v1

/clients/{clientId}/contacts

Returns all contacts attached to a specific client.

List client contacts › path Parameters

clientId

string · required

List client contacts › Responses

List of contacts

success

boolean

object

GET/clients/{clientId}/contacts

curl --request GET \
  --url https://api.most.ac/v1/clients/:clientId/contacts

shell

Example Responses

{
  "success": true,
  "data": {
    "contacts": [
      {
        "id": "cm3x4contact0001",
        "clientId": "cm3x4k8p0000001",
        "type": "REGISTRANT",
        "category": "INDIVIDUAL",
        "firstName": "John",
        "lastName": "Doe",
        "email": "[email protected]",
        "emailPrivacy": true,
        "phoneNumber": "+1.5551234567",
        "country": "United States",
        "countryCode": "US",
        "city": "New York",
        "state": "NY",
        "zip": "10001",
        "address1": "123 Main St",
        "address2": null,
        "createdAt": "2026-03-15T10:30:00.000Z"
      }
    ]
  }
}

json

application/json

Create a contact for a client

POST

https://api.most.ac/v1

/clients/{clientId}/contacts

Attach a new contact to a client. Each client can have up to 4 contacts — one of each type (REGISTRANT, ADMINISTRATOR, TECHNICAL, BILLING).

A REGISTRANT contact is required before a domain can be assigned to this client.

Phone number format

Phone numbers must be in E.164 format with a dot after the country code:

Code
+<country_code>.<subscriber_number>

Examples:

+1.5551234567 (United States, country code 1)
+44.7700900000 (United Kingdom, country code 44)
+7.9001234567 (Russia, country code 7)
+380.501234567 (Ukraine, country code 380)

Full list of country calling codes: Wikipedia: List of country calling codes.

Create a contact for a client › path Parameters

clientId

string · required

Create a contact for a client › Request Body

firstName

string · required

lastName

string · required

type

string · enum

Enum values:

REGISTRANT

ADMINISTRATOR

TECHNICAL

BILLING

Default: REGISTRANT

category

string · enum

Enum values:

INDIVIDUAL

ORGANIZATION

Default: INDIVIDUAL

email

string

emailPrivacy

boolean

Default: true

phoneNumber

string · pattern: ^\+[0-9]{1,4}\.[0-9]…

E.164 format with dot after country code: +<cc>.<number>. Example: +1.5551234567. See country codes list.

Example: +1.5551234567

country

string

countryCode

string

city

string

state

string

zip

string

address1

string

address2

string

Create a contact for a client › Responses

Contact created

success

boolean

object

POST/clients/{clientId}/contacts

curl --request POST \
  --url https://api.most.ac/v1/clients/:clientId/contacts \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "REGISTRANT",
  "category": "INDIVIDUAL",
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "emailPrivacy": true,
  "phoneNumber": "+1.5551234567",
  "country": "United States",
  "countryCode": "US",
  "city": "New York",
  "state": "NY",
  "zip": "10001",
  "address1": "123 Main St"
}
'

shell

Example Request Body

{
  "type": "REGISTRANT",
  "category": "INDIVIDUAL",
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "emailPrivacy": true,
  "phoneNumber": "+1.5551234567",
  "country": "United States",
  "countryCode": "US",
  "city": "New York",
  "state": "NY",
  "zip": "10001",
  "address1": "123 Main St"
}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "contact": {
      "id": "cm3x4contact0001",
      "clientId": "cm3x4k8p0000001",
      "type": "REGISTRANT",
      "category": "INDIVIDUAL",
      "firstName": "John",
      "lastName": "Doe",
      "email": "[email protected]",
      "emailPrivacy": true,
      "phoneNumber": "+1.5551234567",
      "country": "United States",
      "countryCode": "US",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "address1": "123 Main St",
      "address2": null,
      "createdAt": "2026-04-11T00:00:00.000Z"
    }
  }
}

json

application/json

List all contacts

GET

https://api.most.ac/v1

/contacts

Returns a paginated list of all contacts across all your clients, with search and filtering.

Use q to search by first name, last name, or email (case-insensitive substring match). Filter by type to get only registrants/admins/etc., or by clientId to scope to one client.

List all contacts › query Parameters

limit

integer · min: 1 · max: 100

Default: 20

offset

integer

Default: 0

q

string

Search by firstName, lastName, or email (case-insensitive)

Example: john

type

string · enum

Filter by contact type

Enum values:

REGISTRANT

ADMINISTRATOR

TECHNICAL

BILLING

clientId

string

Filter to contacts of a specific client

List all contacts › Responses

List of contacts

success

boolean

object

GET/contacts

curl --request GET \
  --url https://api.most.ac/v1/contacts

shell

Example Responses

{
  "success": true,
  "data": {
    "contacts": [
      {
        "id": "cm3x4contact0001",
        "clientId": "cm3x4k8p0000001",
        "type": "REGISTRANT",
        "category": "INDIVIDUAL",
        "firstName": "John",
        "lastName": "Doe",
        "email": "[email protected]",
        "emailPrivacy": true,
        "phoneNumber": "+1.5551234567",
        "country": "United States",
        "countryCode": "US",
        "city": "New York",
        "state": "NY",
        "zip": "10001",
        "address1": "123 Main St",
        "address2": null,
        "client": {
          "id": "cm3x4k8p0000001",
          "login": "acme-corp"
        },
        "createdAt": "2026-03-15T10:30:00.000Z"
      },
      {
        "id": "cm3x4contact0002",
        "clientId": "cm3x4k8p0000002",
        "type": "ADMINISTRATOR",
        "category": "INDIVIDUAL",
        "firstName": "Jane",
        "lastName": "Smith",
        "email": "[email protected]",
        "emailPrivacy": false,
        "phoneNumber": "+44.7700900000",
        "country": "United Kingdom",
        "countryCode": "GB",
        "city": "London",
        "state": "",
        "zip": "SW1A 1AA",
        "address1": "10 Downing Street",
        "address2": null,
        "client": {
          "id": "cm3x4k8p0000002",
          "login": "example-ltd"
        },
        "createdAt": "2026-03-20T08:00:00.000Z"
      }
    ],
    "total": 2,
    "limit": 20,
    "offset": 0
  }
}

json

application/json

Clients Domains

Create a contact for a client

POST

https://api.most.ac/v1

/clients/{clientId}/contacts

Attach a new contact to a client. Each client can have up to 4 contacts — one of each type (REGISTRANT, ADMINISTRATOR, TECHNICAL, BILLING).

A REGISTRANT contact is required before a domain can be assigned to this client.

Phone number format

Phone numbers must be in E.164 format with a dot after the country code:

Code
+<country_code>.<subscriber_number>

Examples:

+1.5551234567 (United States, country code 1)
+44.7700900000 (United Kingdom, country code 44)
+7.9001234567 (Russia, country code 7)
+380.501234567 (Ukraine, country code 380)

Full list of country calling codes: Wikipedia: List of country calling codes.

Create a contact for a client › path Parameters

clientId

string · required

Create a contact for a client › Request Body

firstName

string · required

lastName

string · required

type

string · enum

Enum values:

REGISTRANT

ADMINISTRATOR

TECHNICAL

BILLING

Default: REGISTRANT

category

string · enum

Enum values:

INDIVIDUAL

ORGANIZATION

Default: INDIVIDUAL

email

string

emailPrivacy

boolean

Default: true

phoneNumber

string · pattern: ^\+[0-9]{1,4}\.[0-9]…

E.164 format with dot after country code: +<cc>.<number>. Example: +1.5551234567. See country codes list.

Example: +1.5551234567

country

string

countryCode

string

city

string

state

string

zip

string

address1

string

address2

string

Create a contact for a client › Responses

Contact created

success

boolean

object

List all contacts

GET

https://api.most.ac/v1

/contacts

Returns a paginated list of all contacts across all your clients, with search and filtering.

Use q to search by first name, last name, or email (case-insensitive substring match). Filter by type to get only registrants/admins/etc., or by clientId to scope to one client.

List all contacts › query Parameters

limit

integer · min: 1 · max: 100

Default: 20

offset

integer

Default: 0

q

string

Search by firstName, lastName, or email (case-insensitive)

Example: john

type

string · enum

Filter by contact type

Enum values:

REGISTRANT

ADMINISTRATOR

TECHNICAL

BILLING

clientId

string

Filter to contacts of a specific client

List all contacts › Responses

List of contacts

success

boolean

object