# Get all ambassadors (manager) **GET /manager/ambassadors** ## Servers - https://domain.tld/api/v2: https://domain.tld/api/v2 () ## Authentication methods - Bearer token ## Parameters #### Query parameters - **sort** (string) example :to sort the ambassadors by firstname (-firstname: descending, firstname: ascending) - **filter[ambassador_search]** (string) retrieve ambassadors by first name, last name,full name, email, email tmp, customer id. - **filter[has_role]** (string) Filter by roles - **filter[active]** (integer) Filter by active status (-3: unsubscribed by brand, -2: unsubscribed, -1: blocked, 0: unactivated, 1: active) - **filter[status]** (integer) 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 - **filter[suspicious]** (boolean) Filter by suspicious status (true/false) - **filter[quarantine]** (boolean) Filter by quarantine status (true/false) - **filter[manager_users_only]** (string) if set to true , only manager users will be returned - **page** (integer) page number - **per_page** (integer) number of items per page ## Responses ### 200: Returns all ambassadors (paginated) #### Body Parameters: application/json (object) - **current_page** (integer(int32)) - **data** (array[object]) - **first_page_url** (string) - **from** (integer(int32)) - **last_page** (integer(int32)) - **last_page_url** (string) - **links** (array[object]) - **next_page_url** (string) - **path** (string) - **per_page** (integer(int32)) - **prev_page_url** (string(nullable)) - **to** (integer(int32)) - **total** (integer(int32)) ### 401: Unauthorized. #### Body Parameters: application/json (object) - **message** (string) ### 403: Forbidden - You don't have permission to access this route [Powered by Bump.sh](https://bump.sh)