# GetContacts

Allows you to retrieve a single contact or a list of contacts.

## Properties

#### Authentication

Authentication values used to connect to the Xero server.

#### Contact id / number

You can retrieve an individual record by specifying the ContactID or ContactNumber.

#### Contact ids

Filter by a comma separated list of ContactIDs. Allows you to retrieve a specific set of contacts in a single call.

#### Modified after

A UTC timestamp (yyyy-mm-ddThh:mm:ss) . Only contacts created or modified since this timestamp will be returned e.g. 2009-11-12T00:00:00

**Note:** changes to the Balances, IsCustomer or IsSupplier values will not trigger a contact to be returned with the Modified-After filter.

#### Where

Restrict the returned items using the specified criteria. See Where filter.

#### Page

e.g. page=1 - Up to 100 contacts will be returned in a single API call.

#### Include archived

e.g. includeArchived=true - Contacts with a status of ARCHIVED will be included in the response.

#### Order by

Return items in a specific order. See Order by filter.

#### Return options

Select how the data is to be returned.

Possible values are:

* Only the first item.
* The first item or an empty item.
* All the items one by one.
* All of the items at once.

## Output

#### Return type of Contacts

A list of contacts or a single contact depending on the selected [Return option](https://github.com/linx-software/linx-docs/blob/v6-Main/reference/plugins/xero/content/contacts/getattachments.md#return-options).

## Links

[Xero Developer: Contacts (GET)](https://developer.xero.com/documentation/api/contacts#GET)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.linx.software/reference/plugins/xero/content/contacts/getcontacts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.