Projects
Get Project
Retrieves a single project by its ID. The project must belong to the organization. Requires an organization admin API key (ASA_ prefix).
GET
/
account
/
projects
/
{projectId}
curl --request GET \
--url https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234 \
--header 'Authorization: Bearer ASA_your-admin-api-key'
import requests
url = "https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234"
headers = {
"Authorization": "Bearer ASA_your-admin-api-key"
}
response = requests.get(url, headers=headers)
print(response.json())
fetch('https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234', {
method: 'GET',
headers: {
'Authorization': 'Bearer ASA_your-admin-api-key'
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
<?php
$url = 'https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ASA_your-admin-api-key'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer ASA_your-admin-api-key")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class GetProject {
public static void main(String[] args) {
try {
URL url = new URL("https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");
con.setRequestProperty("Authorization", "Bearer ASA_your-admin-api-key");
BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuilder content = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
content.append(inputLine);
}
in.close();
con.disconnect();
System.out.println(content.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'uri'
uri = URI('https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer ASA_your-admin-api-key'
response = http.request(request)
puts response.body
{
"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'
import requests
url = "https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234"
headers = {
"Authorization": "Bearer ASA_your-admin-api-key"
}
response = requests.get(url, headers=headers)
print(response.json())
fetch('https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234', {
method: 'GET',
headers: {
'Authorization': 'Bearer ASA_your-admin-api-key'
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
<?php
$url = 'https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ASA_your-admin-api-key'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer ASA_your-admin-api-key")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class GetProject {
public static void main(String[] args) {
try {
URL url = new URL("https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");
con.setRequestProperty("Authorization", "Bearer ASA_your-admin-api-key");
BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuilder content = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
content.append(inputLine);
}
in.close();
con.disconnect();
System.out.println(content.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'uri'
uri = URI('https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer ASA_your-admin-api-key'
response = http.request(request)
puts response.body
{
"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
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
string
required
The project’s unique ID. Must be a valid Mongo ObjectId.
Response
Project retrieved successfullyboolean
Indicates if the request was successfulExample:
trueobject
The project object
Show child attributes
Show child attributes
string
Unique project identifierExample:
"60d5ec49f1b2c72d9c8b1234"string
Project nameExample:
"Production App"string | null
Primary domain associated with the projectExample:
"example.com"object[]
List of email domains configured for the project
string
ISO 8601 timestamp of when the project was createdExample:
"2024-01-15T10:30:00.000Z"boolean
Whether open tracking is enabledExample:
trueboolean
Whether click tracking is enabledExample:
truestring | null
The project’s inbound receiving domain. Present only when inbound is configured.Example:
"token.autosend.email"The response intentionally contains no secrets. It never includes API keys or credentials, SES tokens, or DKIM keys.
Error Responses
object
Returned when the supplied
projectId is not a valid Mongo ObjectId.{
"success": false,
"error":{
"code":"VALIDATION_ERROR",
"message":"Invalid project ID"
}
}
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)"
}
}
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"
}
}
Was this page helpful?
⌘I
curl --request GET \
--url https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234 \
--header 'Authorization: Bearer ASA_your-admin-api-key'
import requests
url = "https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234"
headers = {
"Authorization": "Bearer ASA_your-admin-api-key"
}
response = requests.get(url, headers=headers)
print(response.json())
fetch('https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234', {
method: 'GET',
headers: {
'Authorization': 'Bearer ASA_your-admin-api-key'
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
<?php
$url = 'https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ASA_your-admin-api-key'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer ASA_your-admin-api-key")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class GetProject {
public static void main(String[] args) {
try {
URL url = new URL("https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");
con.setRequestProperty("Authorization", "Bearer ASA_your-admin-api-key");
BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuilder content = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
content.append(inputLine);
}
in.close();
con.disconnect();
System.out.println(content.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'uri'
uri = URI('https://api.autosend.com/v1/account/projects/60d5ec49f1b2c72d9c8b1234')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer ASA_your-admin-api-key'
response = http.request(request)
puts response.body
{
"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"
}
}