---
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
    - `record_type` 'dir_reference', required — Always `dir_reference`.
    - `ref_type` 'business' | 'financial', required — Whether this is a business reference or the financial reference.
    - `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.
    - `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.
    - `relationship_to_registrant` string, nullable — How the reference contact is related to the registering business.
    - `phone_e164` string, required — Reference phone number in E.164 format.
    - `email` string, email, nullable — Reference contact email address.
    - `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/8f5f4e537994/schema)