> ## Documentation Index > Fetch the complete documentation index at: https://docs.theguarantors.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve an application by invite ## OpenAPI ````yaml /openapi/application-api.json get /v1/invites/{invite_id}/application openapi: 3.1.0 info: description: >- Partner API for creating invites, tracking applications, and retrieving bonds. title: TheGuarantors Application API contact: {} version: '1.0' servers: - url: https://api.theguarantors.com security: [] paths: /v1/invites/{invite_id}/application: get: tags: - Applications summary: Retrieve an application by invite parameters: - description: Invite ID name: invite_id in: path required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Application' example: id: sd_3k29dls92jf83kdl status: bound obligee: Acme Property Management LLC invite_id: inv_8f3k2jd9slq02mxp property_id: prop_nvlbcx2e5jk0fqsf bond_id: bond_7f29djw82kdpq9sl lease: start_date: '2026-03-01' end_date: '2027-02-28' monthly_rent: 320000 unit_address: line1: 123 Main St line2: Apt 5B city: New York state: NY postal_code: '10001' object: address object: lease applicants: - id: applc_e91hmctvoraymdpu status: submitted first_name: Jane last_name: Doe email: jane.doe@example.com phone_number: '+12125551234' metadata: {} object: applicant - id: applc_dc6jvyyvb8yw843q status: submitted first_name: John last_name: Smith email: john.smith@example.com phone_number: '+13475559876' metadata: {} object: applicant metadata: {} object: application '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: Missing authorization header object: error '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: application not found object: error '429': description: Rate limit exceeded '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: internal server error object: error security: - BasicAuth: [] components: schemas: Application: type: object required: - applicants - id - invite_id - lease - object - property_id - status properties: applicants: description: >- List of Applicant entities (representing one or more tenants) that are applying for coverage. type: array items: $ref: '#/components/schemas/Applicant' bond_id: type: string example: bond_01HQAB nullable: true id: description: Unique identifier. type: string example: sd_01HQ8Z invite_id: type: string example: inv_01HQ8X lease: description: >- The legal contract between a property manager and the tenant. A lease agreement contains information about the property, the address and duration of the lease, and financial terms like rent amount and security deposit information. Leases map 1:1 with TheGuarantors surety bonds. A single lease can have one or more applicants. allOf: - $ref: '#/components/schemas/Lease' metadata: description: >- Key-value object. Use this field to include internal references, identifiers, or any additional data that helps link this lease to your internal system. Each key must be a string, and values can be strings, numbers, booleans, or null. type: object nullable: true object: type: string example: application obligee: description: >- The party that will be the obligee/claimant on the surety bond. This can be a limited liability company (LLC), a property management company, the property name, or the legal name of a sole proprietor owner. type: string example: Rivermark Residential LLC nullable: true property_id: type: string example: prop_01HQ7A status: description: Enum representing the current state in the application process. allOf: - $ref: '#/components/schemas/ApplicationStatus' example: approved ErrorResponse: type: object required: - message - object properties: message: type: string example: invite not found object: type: string example: error Applicant: type: object required: - email - first_name - id - last_name - object - status properties: email: type: string example: dana.whitfield@example.com first_name: type: string example: Dana id: description: Unique identifier. type: string example: applc_01HQ9A last_name: type: string example: Whitfield metadata: description: >- Key-value object. Use this field to include internal references, identifiers, or any additional data that helps link this lease to your internal system. Each key must be a string, and values can be strings, numbers, booleans, or null. type: object nullable: true object: type: string example: applicant phone_number: description: E.164 formatted phone number type: string example: '+15551234567' nullable: true status: description: >- Enum representing the applicant's current state in the application process. allOf: - $ref: '#/components/schemas/ApplicantStatus' example: submitted Lease: type: object required: - monthly_rent - object - unit_address properties: end_date: description: The date when this lease expires. type: string format: date example: '2027-08-31' nullable: true monthly_rent: description: Monthly rent in cents. type: integer minimum: 1 example: 280000 object: type: string example: lease start_date: description: The date when this lease takes effect. type: string format: date example: '2026-09-01' nullable: true unit_address: description: >- The unit address that would be printed on the lease, and therefore the Lease Guarantee surety bond. If you do not store the address with separate address line 1s and address line 2, put the full unit address in the address line 1. allOf: - $ref: '#/components/schemas/Address' ApplicationStatus: type: string enum: - started - approved - denied - canceled - bound - submitted - pending x-enum-varnames: - APPLICATION_STARTED - APPLICATION_APPROVED - APPLICATION_DENIED - APPLICATION_CANCELED - APPLICATION_BOUND - APPLICATION_SUBMITTED - APPLICATION_PENDING ApplicantStatus: type: string enum: - not_started - started - submitted x-enum-varnames: - APPLICANT_NOT_STARTED - APPLICANT_STARTED - APPLICANT_SUBMITTED Address: type: object required: - city - line1 - object - postal_code - state properties: city: description: City which this address is located in type: string example: Brooklyn line1: description: Address line 1 type: string example: 412 Halsey St line2: description: Address line 2 type: string example: Apt 3R nullable: true object: type: string example: address postal_code: description: Postal or Zip code for this address type: string example: '11233' state: description: State which this address is located in type: string example: NY securitySchemes: BasicAuth: type: http scheme: basic ````