# Practor integration API > REST endpoints that take and answer JSON. Create an integration client and a key in Organization settings, Integrations. Each client can do only what its permissions allow, and every request is in the practice audit log. Version 1.4.0. Base URL https://dashboard.practor.app. Every request sends `Authorization: Bearer `; every POST sends an `Idempotency-Key`. The OpenAPI 3.1 document is at https://developers.practor.app/openapi.json, and everything below is also in one file at https://developers.practor.app/llms-full.txt. ## Guides - [Authenticate with an integration key](https://developers.practor.app/guides/authentication.md): Every request sends a key that belongs to one integration client at one practice. Here's where the key comes from and what it's allowed to do. - [Retry a create safely](https://developers.practor.app/guides/idempotency.md): Every POST needs an Idempotency-Key, so a request you retry after a timeout can never create the same patient, visit or invoice twice. - [Read an error](https://developers.practor.app/guides/errors.md): Every refusal is an RFC 9457 Problem Details body with a status that says what kind of problem it is, a code to branch on, and a list of every field to fix. - [Page through a list](https://developers.practor.app/guides/pagination.md): A list answers with data and a cursor. While hasMore is true, send nextCursor back as cursor for the next page. - [Stay within the rate limits](https://developers.practor.app/guides/rate-limits.md): Each integration client can send 600 requests a minute. Every answer says how many you have left, and a 429 says how long to wait before you carry on. - [Receive and verify webhooks](https://developers.practor.app/guides/webhooks.md): Practor tells your endpoint when an invoice, a claim or a payment changes. Check the signature, answer quickly, and read the invoice with your key. ## Practitioners The practitioners of the practice, to name who saw a patient. - [List the practitioners of the practice, to name who saw a patient](https://developers.practor.app/reference/practitioners/practitioner-search.md): `GET /api/v1/practitioners` ## Patients Register patients and keep their details matched with your system. - [Find a patient by an identifier, such as the practice's own patient number](https://developers.practor.app/reference/patients/patient-search.md): `GET /api/v1/patients` - [Register a patient, with the practice's own patient number](https://developers.practor.app/reference/patients/patient-create.md): `POST /api/v1/patients` - [Read a patient](https://developers.practor.app/reference/patients/patient-read.md): `GET /api/v1/patients/{patientId}` - [Replace a patient's demographics](https://developers.practor.app/reference/patients/patient-update.md): `PUT /api/v1/patients/{patientId}` ## Coverage A patient's medical insurance or private-pay arrangement. - [List a patient's medical insurance and private-pay arrangements](https://developers.practor.app/reference/coverage/coverage-search.md): `GET /api/v1/coverages` - [Record medical insurance or private pay for a patient](https://developers.practor.app/reference/coverage/coverage-create.md): `POST /api/v1/coverages` - [Read a coverage](https://developers.practor.app/reference/coverage/coverage-read.md): `GET /api/v1/coverages/{coverageId}` - [Replace a coverage, such as a new member number](https://developers.practor.app/reference/coverage/coverage-update.md): `PUT /api/v1/coverages/{coverageId}` - [Check medical insurance with the insurer](https://developers.practor.app/reference/coverage/coverage-verify.md): `POST /api/v1/coverages/{coverageId}/verification` ## Insurance plans The medical insurance plans Practor can claim against. - [Find the medical insurance plans Practor can claim against](https://developers.practor.app/reference/insurance-plans/insurance-plan-search.md): `GET /api/v1/insurance-plans` ## Encounters Finished visits, with their diagnoses and procedures, ready to bill. - [List a patient's encounters](https://developers.practor.app/reference/encounters/encounter-search.md): `GET /api/v1/encounters` - [Record a finished visit with its diagnoses and procedures](https://developers.practor.app/reference/encounters/encounter-create.md): `POST /api/v1/encounters` - [Read an encounter](https://developers.practor.app/reference/encounters/encounter-read.md): `GET /api/v1/encounters/{encounterId}` - [Invoice an encounter, optionally issue it and claim from the insurer](https://developers.practor.app/reference/encounters/encounter-bill.md): `POST /api/v1/encounters/{encounterId}/bill` ## Invoices Invoices, the lines on them and the payments made against them. - [Find invoices by encounter or patient, or list the ones that changed](https://developers.practor.app/reference/invoices/invoice-search.md): `GET /api/v1/invoices` - [Read an invoice](https://developers.practor.app/reference/invoices/invoice-read.md): `GET /api/v1/invoices/{invoiceId}` - [Add a line to a draft invoice](https://developers.practor.app/reference/invoices/invoice-line-item-create.md): `POST /api/v1/invoices/{invoiceId}/line-items` - [Replace a line on a draft invoice, such as its price](https://developers.practor.app/reference/invoices/invoice-line-item-update.md): `PUT /api/v1/invoices/{invoiceId}/line-items/{lineItemId}` - [Remove a line from a draft invoice](https://developers.practor.app/reference/invoices/invoice-line-item-delete.md): `DELETE /api/v1/invoices/{invoiceId}/line-items/{lineItemId}` - [List the prices Practor knows for a line](https://developers.practor.app/reference/invoices/invoice-line-item-rates.md): `GET /api/v1/invoices/{invoiceId}/line-items/{lineItemId}/rates` - [Issue a draft invoice](https://developers.practor.app/reference/invoices/invoice-issue.md): `POST /api/v1/invoices/{invoiceId}/issue` - [Reopen an issued invoice to change it](https://developers.practor.app/reference/invoices/invoice-amend.md): `POST /api/v1/invoices/{invoiceId}/amend` - [List the payments made against an invoice](https://developers.practor.app/reference/invoices/invoice-payments.md): `GET /api/v1/invoices/{invoiceId}/payments` ## Claims Send an invoice's claim to the insurer, and resubmit, reverse or cancel it. - [Read the claim's outcome, line by line](https://developers.practor.app/reference/claims/invoice-claim.md): `GET /api/v1/invoices/{invoiceId}/claim` - [Submit the claim for an issued invoice](https://developers.practor.app/reference/claims/claim-submit.md): `POST /api/v1/invoices/{invoiceId}/claim` - [Check whether a claim would be sent](https://developers.practor.app/reference/claims/claim-readiness.md): `GET /api/v1/invoices/{invoiceId}/claim/readiness` - [Resubmit a rejected or reversed claim](https://developers.practor.app/reference/claims/claim-resubmit.md): `POST /api/v1/invoices/{invoiceId}/claim/resubmit` - [Reverse an accepted claim](https://developers.practor.app/reference/claims/claim-reverse.md): `POST /api/v1/invoices/{invoiceId}/claim/reverse` - [Cancel a claim request that is stuck](https://developers.practor.app/reference/claims/claim-cancel.md): `POST /api/v1/invoices/{invoiceId}/claim/cancel` ## Code systems The codes a practice bills and records with: published systems, and the practice's own, such as its tariff. - [List the code systems the practice can use](https://developers.practor.app/reference/code-systems/code-system-search.md): `GET /api/v1/code-systems` - [Create one of the practice's own code systems](https://developers.practor.app/reference/code-systems/code-system-create.md): `POST /api/v1/code-systems` - [Read a code system](https://developers.practor.app/reference/code-systems/code-system-read.md): `GET /api/v1/code-systems/{codeSystemId}` - [Replace one of the practice's own code systems](https://developers.practor.app/reference/code-systems/code-system-update.md): `PUT /api/v1/code-systems/{codeSystemId}` - [List the codes in a code system](https://developers.practor.app/reference/code-systems/code-concept-search.md): `GET /api/v1/code-systems/{codeSystemId}/concepts` - [Add a code to one of the practice's own systems](https://developers.practor.app/reference/code-systems/code-concept-create.md): `POST /api/v1/code-systems/{codeSystemId}/concepts` - [Add many codes to one of the practice's own systems](https://developers.practor.app/reference/code-systems/code-concept-import.md): `POST /api/v1/code-systems/{codeSystemId}/concepts/import` - [Read a code](https://developers.practor.app/reference/code-systems/code-concept-read.md): `GET /api/v1/code-systems/{codeSystemId}/concepts/{conceptId}` - [Replace a code in one of the practice's own systems](https://developers.practor.app/reference/code-systems/code-concept-update.md): `PUT /api/v1/code-systems/{codeSystemId}/concepts/{conceptId}` - [Remove a code from one of the practice's own systems](https://developers.practor.app/reference/code-systems/code-concept-delete.md): `DELETE /api/v1/code-systems/{codeSystemId}/concepts/{conceptId}` ## Webhooks - [An invoice is issued](https://developers.practor.app/reference/webhooks/invoice-issued.md): `invoice.issued` - [An invoice changes status](https://developers.practor.app/reference/webhooks/invoice-status-changed.md): `invoice.status_changed` - [A claim changes status](https://developers.practor.app/reference/webhooks/claim-status-changed.md): `claim.status_changed` - [A payment is recorded](https://developers.practor.app/reference/webhooks/payment-recorded.md): `payment.recorded` - [A patient's medical insurance is checked with the insurer](https://developers.practor.app/reference/webhooks/coverage-verified.md): `coverage.verified` - [A test event](https://developers.practor.app/reference/webhooks/webhook-test.md): `webhook.test`