List Sender Identities

Retrieve a paginated list of the sender identities available to your account.

Every identity is returned, including those not yet ready to send. Check is_sendable before using one as a campaign's from_identity — see Sending readiness. Results are ordered by email address.

Request

GET /sender-identities

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number (min: 1)
per_page	integer	100	Items per page (min: 1, max: 100)

Example Request

curl -X GET "https://email.easy.tools/api/v1/sender-identities" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response

Success Response (200 OK)

{
  "data": [
    {
      "uuid": "be42790c-e33e-4d11-9115-c84ca6c94161",
      "email": "hello@acme.com",
      "from_name": "Acme",
      "reply_to": "support@acme.com",
      "status": "active",
      "is_sendable": true
    },
    {
      "uuid": "c37a1b90-6d24-4e83-bf05-9a2e7c418dd6",
      "email": "news@acme.com",
      "from_name": null,
      "reply_to": null,
      "status": "pending",
      "is_sendable": false
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 100,
    "total": 2
  }
}

Response Fields

Each entry in data has the fields described in Sender Identity Object.

Pagination Object

Field	Type	Description
current_page	integer	Current page number
per_page	integer	Number of items per page
total	integer	Total number of sender identities

Error Responses

Validation Error (422 Unprocessable Entity)

Returned when page or per_page is out of range.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The given data was invalid",
    "details": {
      "per_page": ["The per page field must not be greater than 100."]
    }
  }
}