---
title: "GET security deposit policies"
method: GET
path: "/v3/channels/{channel_id}/security_deposit_policies"
tags: ["Channel Security Deposit Policies"]
---

# GET security deposit policies

`GET /v3/channels/{channel_id}/security_deposit_policies`

## Request

- Base URL: `https://api.bookingexperts.com`
- URL: `https://api.bookingexperts.com/v3/channels/{channel_id}/security_deposit_policies`
- Auth: one of:
  - API key in header `X-API-KEY`
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token`
- TypeScript: <https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/docs/v3/channels/:channel_id/security_deposit_policies/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all security deposit policies belonging to the channel

## Path parameters

- `channel_id` string, required

## Query parameters

- `page[number]` integer
- `page[size]` integer
- `sort` string
- `fields[security_deposit_policy]` string
- `include` string
- `filter[id]` string
- `filter[name]` string
- `filter[amount]` string
- `filter[autorelease_days]` string
- `filter[autorefund]` string
- `filter[deadline_strategy]` string
- `filter[standalone_deadline_days]` string
- `filter[period]` string

## Headers

- `Accept-Language` string

## Response `200`

SecurityDepositPolicyCollectionResponse

- object
  - `data` SecurityDepositPolicy[]
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `name` object: Name of the policy
        - `cs` string
        - `da-DK` string
        - `de` string
        - `de-AT` string
        - `de-CH` string
        - `en-US` string
        - `en-GB` string
        - `es` string
        - `fr` string
        - `fr-BE` string
        - `fr-LU` string
        - `it` string
        - `nb` string
        - `nl` string
        - `nl-BE` string
        - `pl` string
        - `pt` string
        - `tr` string
        - `en` string
        - `da` string
      - `pay_on_arrival` boolean: Whether the deposit is payable on arrival
      - `amount` number, double: The amount of the security deposit
      - `autorelease_days` integer: The number of days after the end of the stay that the security deposit is automatically released
      - `autorefund` boolean: Whether the security deposit is automatically refunded
      - `deadline_strategy` 'first_deadline' | 'last_deadline' | 'standalone_deadline': The strategy used to determine the deadline for the security deposit
      - `standalone_deadline_days` integer: The number of days before arrival that the security deposit is due when using the standalone deadline strategy
      - `if_stay_starts_in` array[]
        - string[]
    - `relationships` object: Relationships
      - `period` object
        - `data` object
          - `id` string: period ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
  - `included` Period[]
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `name` object
        - `cs` string
        - `da-DK` string
        - `de` string
        - `de-AT` string
        - `de-CH` string
        - `en-US` string
        - `en-GB` string
        - `es` string
        - `fr` string
        - `fr-BE` string
        - `fr-LU` string
        - `it` string
        - `nb` string
        - `nl` string
        - `nl-BE` string
        - `pl` string
        - `pt` string
        - `tr` string
        - `en` string
        - `da` string
    - `relationships` object: Relationships
      - `period_entries` object
        - `data` object[]
          - `id` string: period_entries ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
  - `meta` object
    - `pagination` object
      - `total_records` integer
      - `page` integer
      - `size` integer

## Other responses

- `429`: Error
- `default`: Error

## Changes

- **2026-11-03** `ff81bc4fefa9`: 6 info
  - added the optional property `data/items/attributes/name/da-DK` to the response with the `200` status
  - added the optional property `data/items/attributes/name/en-GB` to the response with the `200` status
  - added the optional property `data/items/attributes/name/en-US` to the response with the `200` status
  - added the optional property `included/items/anyOf[#/components/schemas/Period]/attributes/name/da-DK` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/channels/:channel_id/security_deposit_policies/get.md)

---

[API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)