Skip to main content
GET
/
accounting
/
v2
/
contacts
/
{contactId}
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/v2/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": "[email protected]",
            "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": "[email protected]",
        "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

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