Get a Post by id

GET /{environment}/posts/{id}

Path parameters

  • environment string Required

    The environment

    Values are widget or manager.

  • id integer Required

    The ambassador post id

Responses

  • 200 application/json

    Returns the order

    Hide response attributes Show response attributes object
    • id_ambassador_post integer(int32)
    • id_ambassador_post_shared integer(int32)
    • date_post string(date-time)
    • date_insert string(date-time)
    • date_update string(date-time)
    • author object

      Additional properties are allowed.

      Hide author attributes Show author attributes object
      • id_ambassador integer(int32)
      • image string
      • firstname string
      • lastname string
      • username string
      • email string
      • email_tmp string
      • active integer(int32)
      • status integer(int32)
      • online boolean

        true: when last_action_date is less than 5 minutes ago

      • last_action_date string(date-time)
      • customer_id string
      • anonymized boolean
    • type string(nullable)
    • content string(nullable)
    • nb_likes integer(int32)
    • nb_comments integer(int32)
    • visibility string(nullable)
    • view_on_blog boolean
    • products array[object]
      Hide products attributes Show products attributes object
      • id_product integer(int32)
      • name string(nullable)
      • type string(nullable)
      • discount_percentage number(float)
      • price_catalog integer(float)
      • reference_unit_price integer(float)
      • sku string(nullable)
      • youtube_id string(nullable)
      • url string(nullable)
      • description string(nullable)
      • images array[object]
        Hide images attributes Show images attributes object
        • id_i18n_content integer
        • lang string

          Values are en_GB, fr_FR, es_ES, or de_DE.

        • content string
      • price number(float)
      • stock integer(float)
      • stock_available number(float)
      • old_image string(nullable)
    • comments array[object]
      Hide comments attributes Show comments attributes object
      • id_ambassador_post integer(int32)
      • author object

        Additional properties are allowed.

        Hide author attributes Show author attributes object
        • id_ambassador integer(int32)
        • image string(nullable)
        • full_name string
        • username string(nullable)
        • description string
        • status integer(int32)
        • availability string(nullable)
        • unavailable boolean
        • is_absent boolean
        • absent_msg string(nullable)
        • fb_account string(nullable)
        • twitter_account string(nullable)
        • instagram_account string(nullable)
        • linkedIn_account string(nullable)
        • youtube_account string(nullable)
        • online boolean

          true: when last_action_date is less than 5 minutes ago

        • last_action_date string
        • location string

          Label of the point of sale, or city of the ambassador

      • content string(nullable)
      • nb_likes integer(int32)
      • comments array[object]

        Additional properties are allowed.

      • date_created string(date-time)
      • date_timestamp boolean
      • liked boolean
    • videos array[object]
      Hide videos attributes Show videos attributes object
      • id_video integer
      • date_insert string(date-time)
      • date_update string(date-time)
      • date_delete string(date-time)
      • id_blob string
      • state integer

        Values are 0, 1, 2, or 3.

    • nb_orders integer(int32)
    • liked boolean
    • contents array[object]
      Hide contents attributes Show contents attributes object
      • id_i18n_content integer
      • lang string

        Values are en_GB, fr_FR, es_ES, or de_DE.

      • content string
    • titles array[object]
      Hide titles attributes Show titles attributes object
      • id_i18n_content integer
      • lang string

        Values are en_GB, fr_FR, es_ES, or de_DE.

      • content string
    • is_planned boolean
    • shares integer(int32)
    • status string(nullable)
    • is_brand boolean
    • is_akn boolean
    • data1 string
    • data2 string
    • thread_last_update string(date-time)
    • start_date string(date-time)
    • is_on_boarding boolean
    • is_welcome boolean
    • shareable boolean
    • no_comment boolean
    • id_popliste number
  • 401 application/json

    Unauthorized.

    Hide response attribute Show response attribute object
    • message string
  • 403

    Forbidden - You don't have permission to access this route

  • 404

    Not found - The Ambassador Post does not exist

GET /{environment}/posts/{id}
curl \
 --request GET 'https://domain.tld/api/v2/manager/posts/{id}' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "id_ambassador_post": 42,
  "id_ambassador_post_shared": 42,
  "date_post": "2025-05-04T09:42:00Z",
  "date_insert": "2025-05-04T09:42:00Z",
  "date_update": "2025-05-04T09:42:00Z",
  "author": {
    "id_ambassador": 42,
    "image": "string",
    "firstname": "string",
    "lastname": "string",
    "username": "string",
    "email": "string",
    "email_tmp": "string",
    "active": 42,
    "status": 42,
    "online": true,
    "last_action_date": "2025-05-04T09:42:00Z",
    "customer_id": "string",
    "anonymized": true
  },
  "type": "string",
  "content": "string",
  "nb_likes": 42,
  "nb_comments": 42,
  "visibility": "PUBLIC",
  "view_on_blog": true,
  "products": [
    {
      "id_product": 42,
      "name": "string",
      "type": "string",
      "discount_percentage": 42.0,
      "price_catalog": 42,
      "reference_unit_price": 42,
      "sku": "string",
      "youtube_id": "string",
      "url": "string",
      "description": "string",
      "images": [
        {
          "id_i18n_content": 42,
          "lang": "en_GB",
          "content": "Hello"
        }
      ],
      "price": 42.0,
      "stock": 42,
      "stock_available": 42.0,
      "old_image": "string"
    }
  ],
  "comments": [
    {
      "id_ambassador_post": 42,
      "author": {
        "id_ambassador": 42,
        "image": "string",
        "full_name": "string",
        "username": "string",
        "description": "string",
        "status": 42,
        "availability": "string",
        "unavailable": true,
        "is_absent": true,
        "absent_msg": "string",
        "fb_account": "string",
        "twitter_account": "string",
        "instagram_account": "string",
        "linkedIn_account": "string",
        "youtube_account": "string",
        "online": true,
        "last_action_date": "string",
        "location": "Paris"
      },
      "content": "string",
      "nb_likes": 42,
      "comments": [
        {}
      ],
      "date_created": "2025-05-04T09:42:00Z",
      "date_timestamp": true,
      "liked": true
    }
  ],
  "videos": [
    {
      "id_video": 1,
      "date_insert": "2023-10-09T12:12:40.220000Z",
      "date_update": "2023-10-09T12:12:40.220000Z",
      "date_delete": "2023-10-09T12:12:40.220000Z",
      "id_blob": "f0dab429-ae29-4e26-b6ea-138d351831eb",
      "state": 0
    }
  ],
  "nb_orders": 42,
  "liked": true,
  "contents": [
    {
      "id_i18n_content": 42,
      "lang": "en_GB",
      "content": "Hello"
    }
  ],
  "titles": [
    {
      "id_i18n_content": 42,
      "lang": "en_GB",
      "content": "Hello"
    }
  ],
  "is_planned": true,
  "shares": 42,
  "status": "PUBLISHED",
  "is_brand": true,
  "is_akn": true,
  "link": 42.0,
  "data1": "string",
  "data2": "string",
  "thread_last_update": "2025-05-04T09:42:00Z",
  "start_date": "2025-05-04T09:42:00Z",
  "is_on_boarding": true,
  "is_welcome": true,
  "shareable": true,
  "no_comment": true,
  "id_popliste": 42.0
}
Response examples (401)
{
  "message": "Unauthorized."
}