# List all contacts

**GET /contacts**

Retrieve all contacts shared by the team


## Servers
- Production server.: https://api.usecollect.com/v1 (Production server.)


## Authentication methods
- Basic auth


## Parameters


### Query parameters
- **offset** (integer)
  Ranking number of the first item on the page
- **limit** (integer)
  Number of results to return
- **sort** (string)
  Specify how to sort the results
- **search** (string)
  String to look up. It will look up into email, first name, last name, and custom attributes. Will return partial matches.
- **email** (string)
  Email address you want to look up. This search is an exact match and is case-sensitive.
- **firstname** (string)
  First name you want to look up. This search is an exact match and is not case-sensitive.
- **lastname** (string)
  Last name you want to look up. This search is an exact match and is not case-sensitive.


## Responses
### 200
Success

#### Body: application/json (array[object])
- **_id** (string)

- **email** (string(email))

- **firstName** (string)

- **lastName** (string)

- **company** (string)

- **tag** (array[string])

- **custom** (array[object])


### 400
Bad Request -- Your request is invalid.

### 401
Unauthorized -- Your API key is wrong.

### 403
Forbidden -- The object requested is hidden for administrators only.

### 404
Not Found -- The specified object could not be found.

### 429
Too Many Requests -- You're requesting too many objects! Slow down!

### 500
Internal Server Error -- We had a problem with our server. Try again later.

### 503
Service Unavailable -- We're temporarily offline for maintenance. Please try again later.


[Powered by Bump.sh](https://bump.sh)