# List the advisory contacts

GET

/projects/{projectId}/advisory-contacts

```js
const url = 'https://zkao.io/api/v1/projects/example/advisory-contacts?page=1&limit=50&tier=EMBARGO&status=ACTIVE';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url 'https://zkao.io/api/v1/projects/example/advisory-contacts?page=1&limit=50&tier=EMBARGO&status=ACTIVE' \
  --header 'Authorization: Bearer <token>'
```

* Production`zkao.io/api/v1/projects/{projectId}/advisory-contacts`
* Staging`staging.zkao.io/api/v1/projects/{projectId}/advisory-contacts`

Requires scope: `contacts:read`. The programme’s contact list, oldest first, which is the order to read it in when reconciling against a record kept elsewhere.

Its own scope, not `read`: this list is other people’s work addresses and the record of who learns about a vulnerability before the public does, so a routine pipeline token does not reach it.

`software` on each row is what notices are matched on. A project with no security programme reads as an empty list.

## Authorizations

* **[bearerAuth](https://docs.zkao.io/api/#bearerauth)**

## Parameters

### Path Parameters

* **projectId**

  required

  string

### Query Parameters

* **page**

  integer

  default: 1 >= 1

* **limit**

  integer

  default: 50 >= 1 <= 100

* **tier**

  string

  Allowed values: EMBARGO DOWNSTREAM ANNOUNCE

* **status**

  string

  Allowed values: ACTIVE PENDING_VERIFICATION BOUNCED UNSUBSCRIBED

## Responses

### 200

OK

application/json

object

* **items**

  required

  Array\<object>

  object

  * **id**

    required

    string

  * **email**

    required

    string

  * **organization**

    required

    string

  * **tier**

    required

    string

  * **status**

    required

    `PENDING_VERIFICATION` until the contact confirms the address. An unconfirmed address receives nothing embargoed.

    string

  * **software**

    required

    The software this contact runs, which notices are matched on.

    Array\<object>

    object

    * **owner**

      required

      string

    * **name**

      required

      string

  * **createdAt**

    required

    string format: date-time

* **page**

  required

  integer

* **limit**

  required

  integer

* **total**

  required

  integer

##### Examplegenerated

```json
{
  "items": [
    {
      "id": "example",
      "email": "example",
      "organization": "example",
      "tier": "example",
      "status": "example",
      "software": [
        {
          "owner": "example",
          "name": "example"
        }
      ],
      "createdAt": "2026-04-15T12:00:00Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1
}
```

### 400

Invalid request

application/json

object

* **error**

  required

  object

  * **code**

    required

    string

    Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits budget_below_minimum repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

  * **message**

    required

    string

  * **minimumCredits**

    Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.

    integer

##### Example

```json
{
  "error": {
    "code": "unauthorized"
  }
}
```

### 401

Missing, malformed, expired, or revoked token

application/json

object

* **error**

  required

  object

  * **code**

    required

    string

    Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits budget_below_minimum repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

  * **message**

    required

    string

  * **minimumCredits**

    Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.

    integer

##### Example

```json
{
  "error": {
    "code": "unauthorized"
  }
}
```

### 403

The token lacks the required scope

application/json

object

* **error**

  required

  object

  * **code**

    required

    string

    Allowed values: unauthorized forbidden not_found bad_request conflict insufficient_credits budget_below_minimum repository_initializing diff_base_required diff_base_not_allowed diff_base_invalid diff_empty rate_limited internal

  * **message**

    required

    string

  * **minimumCredits**

    Budget_below_minimum only: the least the launch could have reserved, in credits. A diff scan’s first scan of a repository also builds its overview, so its minimum is higher.

    integer

##### Example

```json
{
  "error": {
    "code": "unauthorized"
  }
}
```
