Skip to main content
GET
/
accounting
/
contacts
/
{contactId}
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/contacts/{contactId} \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "id": "92c4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "addresses": [
      {
        "addressLine1": "Lucky street 1",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "companyName": "maesn",
    "contactPersons": [
      {
        "id": "967188f6-8248-4765-b1e8-0f13a3ddb616",
        "emailAddresses": [
          {
            "email": "john.doe@company.com",
            "type": "BUSINESS"
          }
        ],
        "firstName": "John",
        "lastName": "Doe",
        "phoneNumbers": [
          {
            "number": "+49 7163307056",
            "type": "MOBILE"
          }
        ],
        "salutation": "Mr"
      }
    ],
    "contactType": "CONTACT_PERSON",
    "createdDate": "2025-06-01T11:09:11.533Z",
    "emailAddresses": [
      {
        "email": "john.doe@company.com",
        "type": "BUSINESS"
      }
    ],
    "isCustomer": true,
    "isSupplier": false,
    "number": "1042",
    "phoneNumbers": [
      {
        "number": "+49 7163307056",
        "type": "MOBILE"
      }
    ],
    "projectId": "3",
    "updatedDate": "2025-06-01T11:09:11.533Z",
    "website": "https://www.maesn.com"
  }
}

Field support per integration

This endpoint is asynchronous. If the request has not completed, the response returns a taskId. Use /asyncTask/{taskId} to check the task status and obtain the final result once it is ready.
Support rawData: false
Supported Response Fields:
id
string
addresses
Address[]
companyName
string
contactType
enum
Available options: CONTACT_PERSON, COMPANY
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
contactPersons
ContactPerson[]
emailAddresses
EmailAddress[]
isCustomer
boolean
isSupplier
boolean
number
string
phoneNumbers
PhoneNumber[]
updatedDate
string
Support rawData: trueSupported Response Fields:
id
string
addresses
Address[]
companyName
string
contactPersons
ContactPerson[]
contactType
enum
Available options: CONTACT_PERSON, COMPANY
emailAddresses
EmailAddress[]
phoneNumbers
PhoneNumber[]
updatedDate
string
website
string
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Support rawData: trueSupported Response Fields:
id
string
addresses
Address[]
companyName
string
contactPersons
ContactPerson[]
contactType
enum
Available options:COMPANY
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
emailAddresses
EmailAddress[]
isCustomer
boolean
isSupplier
boolean
phoneNumbers
PhoneNumber[]
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
website
string
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId is correctly populated. You can obtain this value by using the GET Companies endpoint available under the Authentication section.
Support rawData: trueSupported Response Fields:
id
string
addresses
Address[]
companyName
string
contactPersons
ContactPerson[]
contactType
enum
Available options:COMPANY, CONTACT_PERSON
createdDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
emailAddresses
EmailAddress[]
isCustomer
boolean
isSupplier
boolean
phoneNumbers
PhoneNumber[]
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Support rawData: trueSupported Response Fields:
id
string
addresses
Address[]
companyName
string
contactType
enum
Available options: COMPANY
emailAddresses
EmailAddress[]
isCustomer
boolean
isSupplier
boolean
number
string
phoneNumbers
PhoneNumber[]
updatedDate
string
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

Headers

X-API-KEY
string
required

API key

X-ACCOUNT-KEY
string
required

Account key

Path Parameters

contactId
string
required

Query Parameters

companyId
string
environmentName
string
rawData
boolean

Response

200 - application/json
meta
object
data
object
Last modified on February 25, 2026