Skip to main content
GET
/
accounting
/
v2
/
contacts
cURL
curl --request GET \
  --url https://api.maesn.dev/accounting/v2/contacts
{
  "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.
Supported filters: lastModifiedAt
Support pagination: true
Support rawData: true
Supported 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: true
Supported 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: true
Supported 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

API key

X-ACCOUNT-KEY
string

Account key

Query Parameters

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

Response

200 - application/json
meta
object
data
object[]