---
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 1 and 2) followed by the single financial reference. Each entry carries its `ref_type` and `slot`, which together address the reference when updating it, alongside the details supplied when it was submitted (name, title, organization, relationship, phone, email, timezone). No internal identifiers are exposed. 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, counting from 1. Business references occupy slots 1 and 2, in the order they were sent in the `business_references` array; the financial reference occupies slot 1. Use this value together with `ref_type` to address the reference when updating it.
    - `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.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)