GET
/
history
/
:id
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl
{
    "tier": "business",
    "status": "success",
    "mediaUrls": [
        "https://images.ayrshare.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", // Ayrshare 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"
}
Available on Premium, Business, Enterprise plans.

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

Header Parameters

Authorization
string
required
API Key of the Primary Profile.

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

Format: Profile-Key: PROFILE_KEY

Path Parameters

id
string
required

Ayrshare Post ID returned from /post

Query Parameters

searchAllPosts
boolean
default:false

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

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl
{
    "tier": "business",
    "status": "success",
    "mediaUrls": [
        "https://images.ayrshare.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", // Ayrshare 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"
}