---
title: "Payment status for lease signing"
method: GET
path: "/leases/{lease_id}/payment/signature-status"
tags: ["Leases", "Credits"]
---

# Payment status for lease signing

`GET /leases/{lease_id}/payment/signature-status`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/payment/signature-status`
- Auth: HTTP bearer

Retrieves the payment status required to initiate electronic signing of the lease.
Includes tracking of invitations sent and authorized limits.

## Path parameters

- `lease_id` string, uuid, required

## Response `200`

Signature payment status retrieved successfully

- object
  - `is_paid` boolean, required: Indicates whether payment has been made
  - `payment_id` string, uuid, nullable: Associated payment ID (null if unpaid)
  - `status` string, nullable: Payment status (e.g., succeeded, pending)
  - `paid_at` string, date-time, nullable: Payment date and time
  - `total_invitations_sent` integer, required: Total number of signature invitations sent
  - `max_invitations` integer, required: Maximum number of authorized invitations
  - `remaining_invitations` integer, required: Number of remaining invitations
  - `payment_required` boolean, required: Indicates whether payment is required to initiate signing

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Lease not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)
