---
title: "Get call links"
method: GET
path: "/call-link/1/links"
tags: ["channels", "webrtc-calls", "call-link", "call-links"]
---

# Get call links

`GET /call-link/1/links`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/call-link/1/links`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Use this method to retrieve all call links.

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Success.

- D32f709b8e696d073f5212b1e1d90721a8fd1118bf2c8abce078bf2baf7d1707CallLinkPage
  - `results` Ae8a6eecccfb565f1840ac10e7bfb960a35d1e256ae31abf1bdea45a1d2f5557CallLink[]: The list of the results for this page.
    - `id` string: Identifier of the created call link. To open a call link, it should be concatenated to the URL: https://call-link.com/.
    - `url` string: A URL to initiate a call.
    - `identity` string, required: Identity of a user who will use a call link.
    - `displayName` string: Display name of a user who will use a call link to initiate a call.
    - `showIdentity` boolean: Show identity or displayName on before a call.
    - `destination` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14Destination, required: Description of who or what is going to receive a call.
      - `type` 'WEBRTC' | 'CONVERSATIONS' | 'ROOM' | 'PHONE' | 'VIBER' | 'APPLICATION'
    - `customData` object: Custom attributes sent in a call once it is started.
    - `validityWindow` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14ValidityWindow: Description of a call link validation period and the number of times it can be used within the range.
      - `oneTime` boolean: By default, call links are generated for multiple calls.If you want to limit the period for how long a link is valid, specify the start and end time. If you want to invalidate a link after establishing a call, set this value to 'true' (defaults to 'false').For ROOM calls, this value cannot be 'true'.
      - `startTime` string, date-time: Specify starting moment in the UTC timezone for when a call link becomes valid. Defaults to the time when a link was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
      - `endTime` string, date-time: Specify ending moment in the UTC timezone for when a call link becomes invalid. Default value is 24 hours after a link was created. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSS+ZZZZ`.
      - `acceptableHours` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14AcceptableHours: Specify time range within a day when a link can be used. It is 00:00 - 23:59, by default. UTC timezone is used.
        - `start` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14TimeOfDay
          - `hour` integer
          - `minute` integer
        - `end` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14TimeOfDay
          - `hour` integer
          - `minute` integer
      - `acceptableDays` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14DayOfWeek[]: Specify the days a link can be used. It is every day of the week, by default.
    - `callLinkConfigId` string: ID of a configuration to use on an existing call link. If this parameter is not sent, and there are some call link configurations, the default one will be used. If there is no configurations, then the one with the system default values will be used.
  - `paging` 2188fec7c48e989bb7053521bdef9d76d71def96483c5304f01cd7e0878f8f14PageInfo: Contains information about the page.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)