# List timeshifts

Filter timeshifts: - By resource ids or external ids - For a specific time interval use _from_ and _to_ parameters - For specific days use _day[]_ parameter, day format is YYYY-MM-DD These filters are mutually exclusive and cannot be used at the same time, if fields _from_ and _to_ are sent, _day[]_ will be ignored

Endpoint: GET /v1/timeshifts
Version: 0.0.4
Security: BearerAuth

## Query parameters:

  - `from` (string)
    Filter timeshifts from start date (format: YYYY-MM-DD). Mutually exclusive with day parameter.

  - `to` (string)
    Filter timeshifts to end date (format: YYYY-MM-DD). Mutually exclusive with day parameter.

  - `day` (string)
    Filter timeshifts for a specific day (format: YYYY-MM-DD). Mutually exclusive with from/to parameters.

  - `resource_ids` (array)
    Filter timeshifts by resource IDs. Comma-separated list of valid MongoDB IDs.
    Example: ["65f4c840b6f1a10012ab34cd"]

  - `resource_external_ids` (array)
    Filter timeshifts by resource external IDs. Comma-separated list of external identifiers.
    Example: ["ext-resource-001"]

  - `page` (integer)
    Page number (1-based).
    Example: 1

  - `limit` (integer)
    Maximum items per page.
Default: 10000 (when not provided or when provided value ≤ 0).
    Example: 50

## Header parameters:

  - `company-id` (string)
    Company MongoDB id used in auth context.
    Example: "65f4c840b6f1a10012ab34cd"

## Response 200 fields (application/json):

  - `data` (array, required)
    List payload.
    Example: [{"id":"65f4c840b6f1a10012ab34cd","externalId":"ext_1001","firstName":"John","lastName":"Doe","fullName":"John Doe","email":"john@example.com","totalBookings":5,"createdAt":"2024-01-15T10:30:00Z","updatedAt":"2024-02-20T14:45:30Z","ts":1708430730},{"id":"65f4c840b6f1a10012ab34ce","externalId":"ext_1002","firstName":"Jane","lastName":"Smith","fullName":"Jane Smith","email":"jane@example.com","totalBookings":3,"createdAt":"2024-01-20T11:15:00Z","updatedAt":"2024-02-25T13:22:00Z","ts":1708516200}]

  - `meta` (object)

  - `meta.page` (integer, required)
    Current page number.
    Example: 1

  - `meta.limit` (integer, required)
    Items requested per page.
    Example: 20

  - `meta.totalItems` (integer, required)
    Total items available.
    Example: 182

  - `meta.totalPages` (integer, required)
    Total pages available.
    Example: 10

  - `total` (integer)
    Total count used by legacy list endpoints.
    Example: 182

  - `status` (integer)
    Operation status flag.
    Example: 1

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message.
    Example: "Invalid request payload"

  - `name` (string)
    Error class name.
    Example: "BadRequestError"

  - `errorCode` (string)
    Application-specific error code.
    Example: 2

  - `details` (object)
    Structured error details.
    Example: {"query":{"page":"invalid"}}

  - `extras` (object,null)
    Extra error metadata from downstream services.
    Example: {"code":"GRAPHQL_VALIDATION_FAILED"}

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message.
    Example: "Invalid request payload"

  - `name` (string)
    Error class name.
    Example: "BadRequestError"

  - `errorCode` (string)
    Application-specific error code.
    Example: 2

  - `details` (object)
    Structured error details.
    Example: {"query":{"page":"invalid"}}

  - `extras` (object,null)
    Extra error metadata from downstream services.
    Example: {"code":"GRAPHQL_VALIDATION_FAILED"}

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message.
    Example: "Invalid request payload"

  - `name` (string)
    Error class name.
    Example: "BadRequestError"

  - `errorCode` (string)
    Application-specific error code.
    Example: 2

  - `details` (object)
    Structured error details.
    Example: {"query":{"page":"invalid"}}

  - `extras` (object,null)
    Extra error metadata from downstream services.
    Example: {"code":"GRAPHQL_VALIDATION_FAILED"}