Credentials

List credentials for a tenant

Changed on Feb 8, 2026

List all SMTP and API credentials for a tenant. Credentials are used to send emails via Ark on behalf of the tenant.

Security: Credential keys are not returned in the list response. Use the retrieve endpoint with reveal=true to get the key.

get/tenants/{tenantId}/credentials

Request

Base URL
https://api.arkhq.io/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/arkhq-io/apis/ark-email-api/docs/tenants/:tenantId/credentials/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

tenantIdstring required

The tenant ID

Query parameters

pageinteger

Page number (1-indexed)

perPageinteger

Number of items per page (max 100)

type'smtp' | 'api'

Filter by credential type

Response

List of credentials

pageinteger required

Current page number (1-indexed)

perPageinteger required

Items per page

totalinteger required

Total number of credentials

totalPagesinteger required

Total number of pages

Example response

{
  "data": [
    {
      "id": 123,
      "name": "production-smtp",
      "type": "smtp",
      "lastUsedAt": "2026-02-03T10:30:00Z",
      "createdAt": "2026-01-15T08:00:00Z",
      "updatedAt": "2026-02-03T10:30:00Z"
    }
  ],
  "page": 1,
  "perPage": 30,
  "total": 5,
  "totalPages": 1,
  "meta": {
    "requestId": "req_V1StGXR8_Z5jdHi6"
  }
}

Changes

Feb 8, 202637bce0c9a4d7 Revision changes
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
Feb 8, 20264f8eeb0b9933 Revision changes
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status

Operation history (3 revisions)