---
title: "List a DIR's references"
method: GET
path: "/dir/{dir_id}/references"
tags: ["DIR References"]
---

# List a DIR's references

`GET /dir/{dir_id}/references`

List the business and financial references submitted for a DIR.

Returns the two business references (slots 0 and 1) followed by the single financial reference. Each entry carries only the customer-supplied details (name, title, organization, relationship, phone, email, timezone). Returns an empty list when no references were submitted.

## Path parameters

- `dir_id` string, uuid, required

## Response `200`

The DIR's references.

- ReferenceList
  - `data` Reference[], required
    - `email` string, email, nullable — Reference contact email address.
    - `full_name` string, required — Full name of the reference contact.
    - `job_title` string, nullable — Job title of the reference contact.
    - `organization` string, nullable — Organization the reference contact belongs to.
    - `phone_e164` string, required — Reference phone number in E.164 format.
    - `record_type` 'dir_reference', required — Always `dir_reference`.
    - `ref_type` 'business' | 'financial', required — Whether this is a business reference or the financial reference.
    - `relationship_to_registrant` string, nullable — How the reference contact is related to the registering business.
    - `slot` integer, required — Position within the reference type. Business references occupy slots 0 and 1; the financial reference occupies slot 0.
    - `timezone` string, required — IANA timezone id for the reference. Calls are only placed within the reference's local 8am-9pm window.

## Other responses

- `404` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/eb02d7e7280b?raw)