Tools

Endpointhttps://api.most.ac/v1

Utility endpoints for integration work — country lookup and fake contact generation.

List countries

GET

https://api.most.ac/v1

/tools/countries

Returns the full list of countries with ISO codes and phone calling codes. Useful for populating country dropdowns or looking up the +CC. prefix for contact creation.

List countries › Responses

200

List of countries

No data returned

Generate a test contact

POST

https://api.most.ac/v1

/tools/generate-contact

Generate a realistic fake INDIVIDUAL contact for testing. The generator picks a random country, produces locale-appropriate name / address / phone number, and assigns an email from your verified mail domains.

The returned email is guaranteed unique — it's cross-checked against the contacts table before being returned, so you can pass it directly to POST /clients/{clientId}/contacts without duplicate errors.

Generate a test contact › Request Body optional

emailDomain

string

Force a specific email domain. If omitted, a random domain from your verified mail servers is used.

Example: test.yourmail.com

Generate a test contact › Responses

Generated contact

No data returned

POST/tools/generate-contact

curl --request POST \
  --url https://api.most.ac/v1/tools/generate-contact \
  --header 'Content-Type: application/json' \
  --data '{}'

shell

Example Request Body

{}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "contact": {
      "category": "INDIVIDUAL",
      "firstName": "Hans",
      "lastName": "Muller",
      "email": "[email protected]",
      "phoneNumber": "+49 30 901820",
      "countryCode": "DE",
      "city": "Berlin",
      "state": "Berlin",
      "address1": "Hauptstrasse 42",
      "address2": null,
      "zip": "10115",
      "dateOfBirth": "1985-07-14",
      "gender": "male",
      "emailPrivacy": true,
      "identificationNumber": "12345678901",
      "individualType": "natural person"
    }
  }
}

json

application/json

Webhooks Providers

Most API

Tools

Endpointhttps://api.most.ac/v1

Utility endpoints for integration work — country lookup and fake contact generation.

List countries

GET

https://api.most.ac/v1

/tools/countries

Returns the full list of countries with ISO codes and phone calling codes. Useful for populating country dropdowns or looking up the +CC. prefix for contact creation.

List countries › Responses

200

List of countries

No data returned

Generate a test contact

POST

https://api.most.ac/v1

/tools/generate-contact

Generate a test contact › Request Body optional

emailDomain

string

Force a specific email domain. If omitted, a random domain from your verified mail servers is used.

Example: test.yourmail.com

Generate a test contact › Responses

Generated contact

No data returned

POST/tools/generate-contact

curl --request POST \
  --url https://api.most.ac/v1/tools/generate-contact \
  --header 'Content-Type: application/json' \
  --data '{}'

shell

Example Request Body

{}

json

application/json

Example Responses

{
  "success": true,
  "data": {
    "contact": {
      "category": "INDIVIDUAL",
      "firstName": "Hans",
      "lastName": "Muller",
      "email": "[email protected]",
      "phoneNumber": "+49 30 901820",
      "countryCode": "DE",
      "city": "Berlin",
      "state": "Berlin",
      "address1": "Hauptstrasse 42",
      "address2": null,
      "zip": "10115",
      "dateOfBirth": "1985-07-14",
      "gender": "male",
      "emailPrivacy": true,
      "identificationNumber": "12345678901",
      "individualType": "natural person"
    }
  }
}

json

application/json

Webhooks Providers