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

# GET security deposit policy

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

## Request

- Base URL: `https://api.bookingexperts.com`
- URL: `https://api.bookingexperts.com/v3/channels/{channel_id}/security_deposit_policies/{id}`
- 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/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a security deposit policy

## Path parameters

- `channel_id` string, required
- `id` string, required

## Query parameters

- `fields[security_deposit_policy]` string
- `include` string

## Headers

- `Accept-Language` string

## Response `200`

SecurityDepositPolicyResponse

- object
  - `data` SecurityDepositPolicy: Security deposit policies determine what kind of security deposits are applied to a Reservation. You can control settings like when they are applied, how much they cost, and how they are invoiced.
    - `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.

## Other responses

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

## Changes

- **2026-11-03** `ff81bc4fefa9`: 6 info
  - added the optional property `data/attributes/name/da-DK` to the response with the `200` status
  - added the optional property `data/attributes/name/en-GB` to the response with the `200` status
  - added the optional property `data/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/:id/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)