Query parameters

  • sort string

    example :to sort the ambassadors by firstname (-firstname: descending, firstname: ascending)

    Values are id_ambassador, firstname, lastname, customer_id, email, active, status, date_insert, gamification_score, sell_token_amount, nb_conversations, nb_diffused_publications, nb_sales, nb_chat_sales, nb_purchases, or pertinence.

  • Filter by roles

  • Filter by active status (-3: unsubscribed by brand, -2: unsubscribed, -1: blocked, 0: unactivated, 1: active)

    Values are -5, -4, -3, -2, -1, 0, or 1.

  • Filter by ambassador status (0: ambassador, 1: employee, 2: administrator, 3: seller, 4: shop manager, 5: manager, 6: expert, 7: client, 8: temp) ex: ?filter[status]=7,8 will return ambassadors with status client or temp

    Values are 0, 1, 2, 3, 4, 5, 6, 7, or 8.

  • Filter by suspicious status (true/false)

  • Filter by quarantine status (true/false)

  • if set to true , only manager users will be returned

  • page integer

    page number

  • per_page integer

    number of items per page

Responses

GET /manager/ambassadors
curl \
 -X GET https://domain.tld/api/v2/manager/ambassadors \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "current_page": 42,
  "data": [
    {
      "id_ambassador": 42,
      "id_brand": 42,
      "date_insert": "string",
      "customer_id": "string",
      "image": "string",
      "gender": "string",
      "firstname": "string",
      "lastname": "string",
      "username": "string",
      "email": "string",
      "email_tmp": "string",
      "gamification_score": 42,
      "suspicious": true,
      "suspicious_date": "string",
      "ignore_suspicious": true,
      "suspicious_quarantine": true,
      "active": 42,
      "status": 42,
      "sell_token_amount": 42,
      "nb_conversations": 42,
      "nb_diffused_publications": 42,
      "online": true,
      "sponsor": 42,
      "nb_sales": 42,
      "nb_chat_sales": 42,
      "nb_purchases": 42,
      "role": [
        "string"
      ],
      "anonymized": true
    }
  ],
  "first_page_url": "string",
  "from": 42,
  "last_page": 42,
  "last_page_url": "string",
  "links": [
    {
      "url": "string",
      "label": "string",
      "active": true
    }
  ],
  "next_page_url": "string",
  "path": "string",
  "per_page": 42,
  "prev_page_url": "string",
  "to": 42,
  "total": 42
}
Response examples (401)
{
  "message": "Unauthorized."
}