Skip to main content
GET
/
account
/
projects
/
{projectId}
curl --request GET \
  --url https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234 \
  --header 'Authorization: Bearer ASA_your-admin-api-key'

{
  "success": true,
  "data": {
    "id": "60d5ec49f1b2c72d9c8b1234",
    "name": "Production App",
    "domain": "example.com",
    "domains": [
      {
        "id": "60d5ec49f1b2c72d9c8b5678",
        "domainName": "example.com",
        "verificationStatus": "VERIFIED",
        "regionKey": "us-east-1"
      }
    ],
    "createdAt": "2024-01-15T10:30:00.000Z",
    "trackingOpen": true,
    "trackingClick": true,
    "inboundEmailDomain": "token.autosend.email"
  }
}
This endpoint requires an organization admin API key (ASA_ prefix). Standard project API keys cannot access this endpoint.
curl --request GET \
  --url https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234 \
  --header 'Authorization: Bearer ASA_your-admin-api-key'

{
  "success": true,
  "data": {
    "id": "60d5ec49f1b2c72d9c8b1234",
    "name": "Production App",
    "domain": "example.com",
    "domains": [
      {
        "id": "60d5ec49f1b2c72d9c8b5678",
        "domainName": "example.com",
        "verificationStatus": "VERIFIED",
        "regionKey": "us-east-1"
      }
    ],
    "createdAt": "2024-01-15T10:30:00.000Z",
    "trackingOpen": true,
    "trackingClick": true,
    "inboundEmailDomain": "token.autosend.email"
  }
}

​
Authorizations

​
Authorizations
string | header
required
Organization admin API key header of the form Bearer ASA_<key>. Standard project API keys (AS_ prefix) will receive a 403 error.

​
Path Parameters

​
projectId
string
required
The project’s unique ID. Must be a valid Mongo ObjectId.

​
Response

Project retrieved successfully
​
success
boolean
Indicates if the request was successfulExample: true
​
data
object
The project object
The response intentionally contains no secrets. It never includes API keys or credentials, SES tokens, or DKIM keys.

​
Error Responses

​
400 - Invalid project ID
object
Returned when the supplied projectId is not a valid Mongo ObjectId.
{
 "success": false,
 "error":{
   "code":"VALIDATION_ERROR",
   "message":"Invalid project ID"
 }
}
​
403 - Not an admin key
object
Returned when using a standard project API key instead of an organization admin API key.
{
 "success": false,
 "error":{
   "message":"This endpoint requires an organization admin API key (ASA_ prefix)"
 }
}
​
404 - Project not found
object
Returned when no project with that ID exists in the organization. This is also returned when the project belongs to a different organization.
{
 "success": false,
 "error":{
   "code":"PROJECT_NOT_FOUND",
   "message":"Project not found"
 }
}