Skip to main content
GET
/
counterparts
/
{counterpart_id}
/
contacts
/
{contact_id}
Get a counterpart's contact
curl --request GET \
  --url https://api.sandbox.monite.com/v1/counterparts/{counterpart_id}/contacts/{contact_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-monite-entity-id: <x-monite-entity-id>' \
  --header 'x-monite-version: <x-monite-version>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "address": {
    "city": "Berlin",
    "country": "DE",
    "line1": "Flughafenstrasse 52",
    "postal_code": "10115",
    "line2": "<string>",
    "state": "<string>"
  },
  "counterpart_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "first_name": "Mary",
  "is_default": true,
  "last_name": "O'Brien",
  "email": "contact@example.org",
  "phone": "5551235476",
  "title": "Ms."
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-monite-version
string<date>
required
x-monite-entity-id
string<uuid>
required

The ID of the entity that owns the requested resource.

Example:

"9d2b4c8f-2087-4738-ba91-7359683c49a4"

Path Parameters

contact_id
string<uuid>
required

ID of the contact to return.

counterpart_id
string<uuid>
required

ID of a counterpart whose contact you want to get. Only organization-type counterparts can have contacts.

Response

Successful Response

The contact person for an organization.

id
string<uuid>
required

A unique ID assigned to this counterpart contact.

address
object
required

The address of a contact person.

counterpart_id
string<uuid>
required

ID of the counterpart to which this contact belongs.

first_name
string
required

The first name of a contact person.

Example:

"Mary"

is_default
boolean
required

Indicates whether this contact is the default one. The default contact is used to fill in the counterpart's contact details when you create invoices and quotes for this counterpart.

To select another contact as the default one, use POST /counterparts/{counterpart_id}/contacts/{contact_id}/make_default.

last_name
string
required

The last name of a contact person.

Example:

"O'Brien"

email
string<email>

The email address of a contact person.

Example:

"contact@example.org"

phone
string

The phone number of a contact person

Example:

"5551235476"

title
string

The title or honorific of a contact person. Examples: Mr., Ms., Dr., Prof.

Example:

"Ms."