# Search Events

Endpoint: GET /locations/{location_id}/events/search
Version: 1.0.0
Security: BearerPartner

## Security:

  - `BearerPartner` (unknown)
    http bearer Bearer {PartnerToken}

## Path parameters:

  - `location_id` (number, required)
    ID of a location.

## Query parameters:

  - `from` (string, required)
    Search start date (YYYY-MM-DD format).

  - `till` (string, required)
    Search end date (YYYY-MM-DD format).

  - `service_ids[]` (array)
    Filter by services IDs; repeat `service_ids[]` once per ID.

  - `team_member_ids[]` (array)
    Filter by Team Member IDs; repeat `team_member_ids[]` once per ID.

  - `resource_ids[]` (array)
    Filter by resources IDs; repeat `resource_ids[]` once per ID.

  - `page` (number)
    Page number (default 1).

  - `count` (number)
    Page size (default 25).

## Header parameters:

  - `Accept` (string, required)
    Required B2B v2 response media type. Use `application/vnd.api.v2+json`. A charset parameter is also accepted.

  - `Content-Type` (string, required)
    Should be equal to `application/json`

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `success` (boolean)
    Execution success status (true)

  - `data` (array)
    Array of objects with data

  - `data.id` (number)
    Event ID

  - `data.service_id` (number)
    Service ID

  - `data.company_id` (number)
    Location ID

  - `data.staff_id` (number)
    team member ID

  - `data.date` (string)
    Session date

  - `data.length` (number)
    Duration

  - `data.capacity` (number)
    Capacity

  - `data.records_count` (number)
    Number of appointments

  - `data.color` (string)
    Color

  - `data.instructions` (string)
    Instructions

  - `data.stream_link` (string)
    Link to instructions

  - `data.font_color` (string)
    Font color

  - `data.notified` (boolean)
    Notifications

  - `data.prepaid` (string)
    Prepayment

  - `data.service` (object)
    Service

  - `data.service.id` (number)
    Service ID

  - `data.service.category_id` (number)
    Service category identifier

  - `data.service.title` (string)
    Service name

  - `data.service.price_min` (number)
    The minimum cost of the service

  - `data.service.price_max` (number)
    Maximum cost of the service

  - `data.service.comment` (string)
    A comment

  - `data.service.image_url` (string)
    The path to the image with the image of the service

  - `data.service.salon_service_id` (number)
    Category ID for the location on the chain

  - `data.service.prepaid` (string)
    Prepayment

  - `data.service.category` (object)
    Category

  - `data.service.category.id` (number)
    Category ID

  - `data.service.category.category_id` (number)
    Product category ID (0 if the item is a product)

  - `data.service.category.title` (string)
    name of category

  - `data.staff` (object)
    team member

  - `data.staff.id` (number)
    team member ID

  - `data.staff.api_id` (string | null)
    team member External ID

  - `data.staff.name` (string)
    team member name

  - `data.staff.company_id` (number)
    Location ID

  - `data.staff.specialization` (string)
    team member specialization

  - `data.staff.rating` (number)
    Rating

  - `data.staff.show_rating` (number)
    Whether to show the team member's rating (1 - show, 0 - do not show)

  - `data.staff.avatar` (string)
    Path to team member avatar file

  - `data.staff.avatar_big` (string)
    The path to the team member's avatar file in a higher resolution

  - `data.staff.comments_count` (number)
    Number of comments to the team member

  - `data.staff.votes_count` (number)
    Number of votes that rated a team member

  - `data.staff.average_score` (number)
    Average rating

  - `data.staff.prepaid` (string)
    Indicates whether online payment is available for the appointment

  - `data.staff.position` (any)
    Team Member's position object, or an empty array when no position is assigned

  - `data.staff.position.id` (number)
    Job ID

  - `data.staff.position.title` (string)
    Job Title

  - `data.resource_instances` (array)
    Resource instance

  - `data.resource_instances.id` (number)
    Resource instance ID

  - `data.resource_instances.title` (string)
    Resource instance name

  - `data.resource_instances.resource_id` (number)
    Resource ID

  - `data.labels` (array)
    Post category

  - `meta` (object)
    Metadata (contains the number of Events found)

  - `meta.count` (integer)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: Authentication needed.

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: Access denied.

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object | array)
    Additional response data (empty object or empty array)
    Example: {}