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

Documentation Index

Fetch the complete documentation index at: https://docs.maesn.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
Supported filters: lastModifiedAt
Support pagination: true
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.
Supported filters: lastModifiedAt
Support pagination: true
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
Supported filters: lastModifiedAt
Support pagination: true
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
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
contactType
enum
Available options: CONTACT_PERSON, COMPANY
​
companyName
string
​
contactPersons
ContactPerson[]
​
addresses
Address[]
​
emailAddresses
EmailAddress[]
​
number
string
​
phoneNumbers
PhoneNumber[]
​
updatedDate
string
​
website
string
Supported filters:
  • lastModifiedAt
Support pagination: trueSupport rawData: true
Supported Response Fields:
​
id
string
​
addresses
Address[]
​
companyName
string
​
contactType
enum
Available options: CONTACT_PERSON, COMPANY
​
emailAddresses
EmailAddress[]
​
isCustomer
boolean
​
isSupplier
boolean
​
number
string
​
phoneNumbers
PhoneNumber[]
​
updatedDate
string

Headers

​
X-API-KEY
string
required

API key

​
X-ACCOUNT-KEY
string
required

Account key

Query Parameters

​
page
number
​
limit
enum<number>
Available options:
5,
10,
20,
50,
100
​
lastModifiedAt
string
​
rawData
boolean
​
companyId
string
​
environmentName
string

Response

200 - application/json
​
meta
object
​
data
object[]
Last modified on May 21, 2026