curl --request GET \
--url https://api.indm.social/v1/accounts/{account_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.indm.social/v1/accounts/{account_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.indm.social/v1/accounts/{account_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "6f1c2a9e-3b7d-4e21-9a55-0c8d2f4b7e10",
"workspace_id": "2c5e8a1b-7f3d-4c9e-b0a2-5d6e7f8a9b0c",
"username": "maya.grows",
"followers": 48200,
"status": "connected",
"reason": "token_expired",
"status_changed_at": "2023-11-07T05:31:56Z",
"last_synced_at": "2026-11-05T08:41:12Z"
}{
"error": {
"type": "authentication_error",
"code": "api_key_expired",
"message": "This API key expired on 3 Feb 2027. Create a new one under Settings → API keys.",
"doc_url": "https://docs.indm.social/errors#api_key_expired"
}
}{
"error": {
"type": "not_found",
"code": "media_not_found",
"message": "There's no post with that id in this workspace. GET /v1/media lists them; refresh the account first if it was just published.",
"param": "media_id",
"doc_url": "https://docs.indm.social/errors#media_not_found"
}
}{
"error": {
"type": "rate_limited",
"code": "rate_limited",
"message": "That's more than 120 requests a minute on one key. Wait 18s and try again.",
"doc_url": "https://docs.indm.social/errors#rate_limited"
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "Something went wrong on our end. Try again; if it keeps happening, quote request req_8Qm2ZcY4vN7tLp1K to support@indm.social.",
"doc_url": "https://docs.indm.social/errors#internal_error"
}
}Get an account
One connected Instagram account.
Needs a read or full key.
curl --request GET \
--url https://api.indm.social/v1/accounts/{account_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.indm.social/v1/accounts/{account_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.indm.social/v1/accounts/{account_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "6f1c2a9e-3b7d-4e21-9a55-0c8d2f4b7e10",
"workspace_id": "2c5e8a1b-7f3d-4c9e-b0a2-5d6e7f8a9b0c",
"username": "maya.grows",
"followers": 48200,
"status": "connected",
"reason": "token_expired",
"status_changed_at": "2023-11-07T05:31:56Z",
"last_synced_at": "2026-11-05T08:41:12Z"
}{
"error": {
"type": "authentication_error",
"code": "api_key_expired",
"message": "This API key expired on 3 Feb 2027. Create a new one under Settings → API keys.",
"doc_url": "https://docs.indm.social/errors#api_key_expired"
}
}{
"error": {
"type": "not_found",
"code": "media_not_found",
"message": "There's no post with that id in this workspace. GET /v1/media lists them; refresh the account first if it was just published.",
"param": "media_id",
"doc_url": "https://docs.indm.social/errors#media_not_found"
}
}{
"error": {
"type": "rate_limited",
"code": "rate_limited",
"message": "That's more than 120 requests a minute on one key. Wait 18s and try again.",
"doc_url": "https://docs.indm.social/errors#rate_limited"
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "Something went wrong on our end. Try again; if it keeps happening, quote request req_8Qm2ZcY4vN7tLp1K to support@indm.social.",
"doc_url": "https://docs.indm.social/errors#internal_error"
}
}Authorizations
An API key from Settings → API keys in the inDM app, sent as
Authorization: Bearer indm_.... Keys belong to one workspace and carry a scope:
read for GET routes and the validate dry run, full for everything. Keep keys on
your server; never ship one to a browser or a mobile app.
Path Parameters
The account id from List accounts.
Response
The account.
The account id the other endpoints take.
"6f1c2a9e-3b7d-4e21-9a55-0c8d2f4b7e10"
"2c5e8a1b-7f3d-4c9e-b0a2-5d6e7f8a9b0c"
The Instagram handle, without the @.
"maya.grows"
Follower count at the last sync.
48200
connected when everything is running. needs_reconnect when Instagram has
paused the connection and the creator needs to reconnect in the app; nothing
syncs or sends until then.
connected, needs_reconnect, disconnected, error "connected"
A stable slug for why the account isn't connected. Present only when status
isn't connected.
"token_expired"
When status last changed. Present only when it isn't connected.
When inDM last pulled posts from Instagram.
"2026-11-05T08:41:12Z"