# List Domains

GET /api/v2/projects/{projectId}/domains

Lists the project's domains. Filter by sending status, shortlink state, or readyToSend (ACTIVE and tracking verified — use that when picking a from-domain).

## Request

- projectId: string, path, required — ID of the project to list domains from.
- emailStatus: INACTIVE | PENDING | ACTIVE | ERROR, query — Restrict the result to this sending status: INACTIVE, PENDING, ACTIVE, or ERROR.
- readyToSend: boolean, query — When true, only domains that are ACTIVE and have verified link tracking. Use this when picking a from-domain to send from. Leave it off to include domains still waiting on DNS.
- shortlinkEnabled: boolean, query — Restrict the result to domains with shortlinks on or off.
- vercelConfigured: boolean, query — Restrict the result to domains that have been added to Vercel for shortlinks.
- vercelVerificationStatus: PENDING | VALID | INVALID, query — Restrict the result to this shortlink DNS status: PENDING, VALID, or INVALID.

## Response

- 200: Successful response
- 400: Invalid input data
- 401: Authorization not provided
- 403: Insufficient access
- 404: Not found
- 500: Internal server error
