n8n: list your numbers

Download the importable workflow. It contains a manual trigger and GET /api/v1/dids. It is inactive, with no schedule or token.

SetupCopy Anchor Link

1. Create a token in Desenvolvedores → Tokens with only dids:read and the required number selection.
2. Import the JSON file in n8n.
3. Create an HTTP Header Auth credential. Header name: Authorization. Private value: Bearer, one space, then your token.
4. Select that credential in List my DIDs. Never paste the token into the JSON or a text node.
5. Run Run manually. The result contains dids; an empty array can be valid.

Reading the resultCopy Anchor Link

Each DID includes its numeric id and number. billing:read reveals billing fields; forwarding:read reveals destinations. Grant them only if needed. This is current token-authorized ownership, not sales inventory.

Errors and operationCopy Anchor Link

• 401: check the header, expiration and revocation.
• 403: check scopes, number selection, verification and account restrictions.
• 429: wait for Retry-After. Quotas are shared by the account.
• Timeout: this recipe is read-only; any retries should use bounded backoff.

The workflow disables normal result storage for executions; also check your n8n installation’s retention policies. Never share exports containing credentials, customer data or real execution history. If you add writes later, obtain consent and never apply automatic retries to SMS. See the reference.