Audience: External partners & integrators
Change policy: Non-breaking changes may occur without notice. Breaking
changes require a minimum 30-day deprecation window and a Sunset header on
affected responses.
The CLA Product API exposes user-facing capabilities for Construction Loan
Administration. This section lists beta endpoints only. Production traffic is
allowed but integrations must be prepared for minor, backwards-compatible
adjustments.
All requests must include:
\nTokens will expire based on how they were configured in the Built app under
Settings → API.
Welcome! If this is your first time with the CLA Partner API, this guide will
walk you through the recommended first steps. The API is centered around Deals
(loan agreements). Once you can search and retrieve deals, you can branch into
related resources like checklists, files, draws and inspections.
Start by listing the deals your organization has access to.
\nEndpoint: GET /deal
Purpose: Returns list of deals.
\nUse case: \"Show me all the loans my organization is working on.\"
\nOnce you have a deal_uid (dealUid), you can drill into the deal:
\nGET /deal/{deal_uid} → Core info (status, IDs, product type).
GET /deal/{deal_uid}/details → Extended metadata (loan type, flags,
balances).
Use this to populate dashboards or validate before proceeding.
\nEvery deal can have related resources:
\nChecklist → GET /deal/{deal_uid}/checklist View compliance items
required for funding.
Files → GET /deal/{deal_uid}/files Fetch contracts, permits, inspection
docs.
Draws → GET /deal/{deal_uid}/draws
See funding requests and disbursements.
Inspections → GET /deal/{deal_uid}/inspections
Check scheduled or completed site inspections.
Activity → GET /deal/{deal_uid}/activity?page=1&per_page=10
See related activity information for deal.
\n\n🔑 Pro tip:
\n
1. Always begin with Search for Deals → get a deal_uid → then drill deeper
into the endpoints that matter most to your workflow. This approach
ensures you understand the deal first before moving into compliance,
documents, or funding.
2. Some endpoints require a valid tenant_id to access or filter data
correctly. Make sure you retrieve and include the tenant_id from deal
details before calling these endpoints.
3. Ensure that each lender has a primary administrator assigned. This
association is required for correct authorization, data retrieval, and
access across the CLA Public API endpoints.
API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.getbuilt.com/cla-product-api/public/v1/auth/agent/register","description":"Purpose: Registers a new AI agent user within the caller’s organization and returns credentials/context for subsequent API use.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Authentication and authorization endpoints for verifying tokens and managing user/agent identities
\n","_postman_id":"8ba8707e-abd4-4a5c-8a61-77857afc2596","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/deal","description":"Purpose: Get active deals/loans with comprehensive loan data including financials, borrower information, and status details. Returns loans with status code 10 (Active) for the authenticated bank.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.getbuilt.com/cla-product-api/public/v1/deal","description":"Purpose: Create a new draft deal (loan agreement) in the CLA system. This endpoint is used to initialize a loan record in draft status, which can then be updated and progressed through its lifecycle. Supported product types include Residential, Renovation, Borrowing Base, Lot, and MGLOC, and example payloads for each will be included to guide implementation.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/deal/{dealUid}","description":"Purpose: Fetch a single deal by its unique identifier, including core metadata needed to display and authorize downstream actions.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/deal/{deal_uid}/checklist","description":"Purpose: Retrieve all checklist items associated with a specific loan agreement/ deal (deal_uid). This allows clients to display outstanding requirements, monitor completion, and enforce funding controls based on the readiness of the deal’s supporting tasks.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/deal/{deal_uid}/details","description":"Purpose: Retrieve comprehensive deal details / loan agreement, by its unique identifier (deal_uid). This endpoint returns the full loan metadata, including loan type, status, borrower, builder, financial values, property information, and progress metrics, providing a complete view of the deal’s configuration and current state. It is primarily used after searching for deals to display or process detailed deal/loan agreement information.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/deal/{deal_uid}/files","description":"Purpose: Retrieve the list of files associated with a specific loan agreement / deal (deal_uid). This allows clients to display or download related documents, track their processing status, and ensure that all necessary documentation for the deal is present and accessible.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/deal/{deal_uid}/activity","description":"Purpose: Retrieve a paginated list of loan activities for a specific loan agreement/ deal (deal_uid). This allows clients to display a timeline of actions, such as draw approvals and status updates, while enabling filtering by date and ensuring transparency for compliance and monitoring.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/inspections/{deal_uid}/inspections","description":"Purpose: Retrieves all inspections associated with a specific loan (deal_uid). This endpoint returns detailed inspection information, including scheduled date, completion status, and any associated comments.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Deal management endpoints for creating, retrieving, and managing construction loan deals
\n","_postman_id":"3ca29b6a-d483-4961-b4aa-57d720f0522b","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/deal/{dealUid}/draws","description":"Purpose: Retrieve all draw requests associated with a specific deal/ loan agreement (deal_uid). This endpoint returns a paginated list of draws, including draw identifiers, names, request and transaction dates, amounts, statuses, and related inspection references. It provides a complete view of the deal’s funding activity and is typically used to display or audit draw history for a loan.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/{draw_id}","description":"Purpose: Retrieve detailed information for a specific draw by its unique identifier (draw_id). This endpoint returns all available data for a single draw request, including draw name, type, status, associated inspection, request and transaction dates, and disbursement amount. It is typically used to display or validate draw-level details.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/{draw_id}/details","description":"Purpose: Retrieves comprehensive draw details including budget items, collateral information, inspections, and checklist items. This endpoint performs multiple API calls to gather complete draw information. The endpoint implements fail-fast error handling - any service failure (draw details, permissions, inspections, or checklist) will result in an error response rather than partial data.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/search","description":"Purpose: Execute a search for draws across all deals using filter and sort criteria. This endpoint supports advanced querying to locate specific draw requests: by status, request date, amount, or other indexed fields, and returns a list of matching draw records with pagination. It is typically used to build reporting views or dashboards for monitoring draw activity at scale.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/{draw_id}/approve","description":"Purpose: Approve a specific draw request by its unique identifier (draw_id). This endpoint records the approval action, updating the draw’s status, related budget items, checklist validations, and audit details such as reviewer identity and timestamp. It confirms that the draw has met all required conditions for disbursement and transitions it into an approved state within the funding workflow.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/{draw_id}/ready-to-transfer","description":"Purpose: Marks a specific draw request as ready to transfer by its unique identifier (draw_id). This endpoint updates the draw’s status to “Ready to Transfer,” triggering the next step in the funding workflow.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/{draw_id}/transfer","description":"Purpose: Transfers a specific draw request by its unique identifier (draw_id). This endpoint updates the draw’s status to the specified draw_status_code, marking it as transferred.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/{draw_id}/decline","description":"Purpose: Declines a specific draw request by its unique identifier (draw_id). This endpoint updates the draw’s status to “Declined,” indicating that the draw has not met the required conditions for disbursement.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/{draw_id}/files","description":"Purpose: Retrieve all files associated with a specific draw (draw_id). This endpoint returns metadata for each file, such as name, content type, status, creator, timestamps, and download URL, allowing clients to view or download documents related to a draw request, including invoices, lien waivers, and inspection reports.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.getbuilt.com/cla-product-api/public/v1/draws/{draw_id}/checklist_item/{checklist_item_id}","description":"Purpose: Updates the status of a specific checklist item for a draw. Actions include checking, unchecking, waiving, or deferring the item.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Draw management and processing endpoints for handling construction loan draws, approvals, and transfers
\n","_postman_id":"32f4b0a2-be7e-4ed1-bb4c-4d525429ae65","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/inspections/inspection/{inspection_id}","description":"Purpose: Retrieves detailed information about a specific inspection (inspection_id). This endpoint returns comprehensive inspection details, including scheduled date and completion status.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/inspections/inspection/{inspection_id}/photos","description":"Purpose: etrieve all photos associated with a specific inspection (inspection_id). This endpoint returns metadata for each image, including its URL, caption, creation timestamp, dimensions, and MIME type. It allows users to view and manage the visual evidence collected during an inspection, supporting audit, compliance, and progress tracking workflows.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Inspection scheduling and management endpoints for property inspections
\n","_postman_id":"52cd820a-372f-4c75-b5a9-e379fbd1602f","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"API Key (UUID format)
\n"},{"key":"Authorization","value":"API Secret (UUID format)
\n"}],"url":"https://api.getbuilt.com/cla-product-api/public/v1/product_types","description":"Purpose: Retrieves the list of available product types, which represent the different categories of deals or loan agreements supported by the CLA system. Each product type defines the structure and behavior of a loan, such as Residential, Renovation, Commercial, Line of Credit, or Borrowing Base.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Product type management endpoints for retrieving available product types
\n","_postman_id":"6bf4be6d-b65a-44b2-8efe-ebe77fbac96b","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"