ACME API Documentation logo

Post History by ID

Get the history for a specific post

GEThttps://api.acme.com/api/history/:id
Available on Premium, Business, Enterprise plans.

Get the history for a specific post. Replace :id with the ACME Post ID returned from post.

Header Parameters

Authorizationstringrequired
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
Profile-Keystring
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Path Parameters

idstringrequired

ACME Post ID returned from /post

Query Parameters

searchAllPostsbooleandefault: false

Search all posts across all User Profiles for the post ID. Default: false

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.acme.com/api/history/TBEAAqAMMJoweA9wKHUl
{
    "tier": "business",
    "status": "success",
    "mediaUrls": [
        "https://images.acme.com/imgs/GhostBusters.jpg"
    ],
    "postIds": [
        {
            "platform": "facebook",
            "postUrl": "https://www.facebook.com/1105775157895689_361710168628052",
            "status": "success",
            "id": "105775157895689_361710168628052" // Facebook Social Post ID
        }
    ],
    "id": "TBEEAqAMMJoweA8wKHUp", // ACME Post ID
    "errors": [],
    "platforms": [
        "facebook"
    ],
    "scheduleDate": {   // In a future release changed to "scheduleDate": "2020-11-05T12:21:29Z"
        "_seconds": 1604578889,
        "_nanoseconds": 211000000,
        "utc": "2020-11-05T12:21:29Z"
    },
    "createDate": {    // deprecated, use created
        "_seconds": 1653067506,
        "_nanoseconds": 179000000,
        "utc": "2022-05-20T17:25:06Z"
    },
    "created": "2022-05-20T17:25:06Z",
    "shortenLinks": true,
    "post": "Today is a great day",
    "notes": "Approved by John Smith", // reference notes set via /post
    "type": "scheduled"
}