---
title: "Find a specific lease"
method: GET
path: "/keywords/leases/{keyword}"
tags: ["keywords"]
---

# Find a specific lease

`GET /keywords/leases/{keyword}`

Searches for all keywords owned by user

## Path parameters

- `keyword` string, required

## Query parameters

- `fields` string

## Response `200`

successful operation

- KeywordLease — Represents a lease object for a given keyword
  - `shortCode` string — A short code assigned to keyword. Example: 67076 (Deprecated - please use number instead)
  - `number` string — A number assigned to keyword. Example: 12132212344
  - `keyword` string — A text used as a keyword
  - `leaseBegin` integer — A time of a lease timestamp, formatted in unix time milliseconds (read only). Example: 1473781817000 for Sat, 05 Jan 1985 14:03:37 GMT
  - `leaseEnd` integer — A date and time when the keyword lease is finishes. Timestamp, formatted in unix time milliseconds (read only). Example: 1473781817000
  - `autoRenew` boolean — Enables the auto renewal of a keyword lease at the end of each billing cycle
  - `doubleOptInEnabled` boolean — Enable/disable double opt in feature
  - `optInConfirmationMessage` string — Opt in confirmation message
  - `contactListId` integer — Existing contact list ID
  - `status` 'PENDING' | 'ACTIVE' | 'RELEASED' | 'UNAVAILABLE' — A lease status. Available values: PENDING, ACTIVE, RELEASED, UNAVAILABLE
  - `labels` string[] — ~
  - `type` 'PLAN' | 'EXTRA' — ~

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/callfire/apis/callfire-api-documentation.md) · [All operations](https://skmtc.dev/callfire/apis/callfire-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/callfire/callfire-api-documentation/revisions/9f6fb501bc03/schema)