# One Stop Adjuster

> Send claims to adjusters in the OSA app and follow their acceptance.

- [Introduction](https://docs.osaconnection.com/introduction.md): Send claims from your claims system to adjusters in the OSA app, and know when each one is accepted.
- [Quickstart](https://docs.osaconnection.com/quickstart.md): Send your first test claim and watch it arrive in the OSA app.
- [Authentication](https://docs.osaconnection.com/authentication.md): API keys, environments and permissions.
- [Testing with test accounts](https://docs.osaconnection.com/testing.md): Build and test against production safely, with test keys and test adjusters inside your own firm.
- [Inviting adjusters](https://docs.osaconnection.com/inviting-adjusters.md): Invite adjusters to your firm by OSAID, record who each invitation is for, and follow the answers.
- [Claim details](https://docs.osaconnection.com/claim-details.md): The optional details you can send with a claim, where the adjuster sees them, and the two rules that compare one field with another.
- [Occupancy and building type](https://docs.osaconnection.com/occupancy-and-building-type.md): Which building types go with which occupancy type, and what the API answers when a pair is not allowed.
- [Carrier details](https://docs.osaconnection.com/carrier-details.md): Send the carrier's name, phone, email and address on every claim. They print on the adjuster's forms.
- [Polling for acceptance](https://docs.osaconnection.com/polling.md): Find out which claims were accepted or rejected, efficiently and without missing any.
- [Limits and idempotency](https://docs.osaconnection.com/limits-and-idempotency.md): Rate limits, page sizes, and how to retry writes safely.
- [Errors](https://docs.osaconnection.com/errors.md): Error format, the stable error codes, and what to do about each one.
- [Changelog](https://docs.osaconnection.com/changelog.md): Changes to the OSA Partner API.
- [Send a claim to an adjuster](https://docs.osaconnection.com/api-reference/claims/send-a-claim-to-an-adjuster.md): Creates a claim in your firm and offers it to the adjuster named by `adjuster_osa_id`. The adjuster accepts or rejects it in the OSA app; until then the claim's `assignment.status` is `pending_acceptance`. Poll `GET /v1/claims` to see the outcome.
- [List and poll claims](https://docs.osaconnection.com/api-reference/claims/list-and-poll-claims.md): Lists the claims your firm sent through the API, oldest change first, ordered by `updated_at` and then `id`. This is the endpoint to poll for acceptance: call it every 1 to 5 minutes with `updated_since` rather than polling claims one by one.
- [Get a claim](https://docs.osaconnection.com/api-reference/claims/get-a-claim.md): Returns the claim as you sent it, with its current `assignment`. Adjusters' later edits in the app don't change what this endpoint returns.
- [Offer a claim to another adjuster](https://docs.osaconnection.com/api-reference/claims/offer-a-claim-to-another-adjuster.md): Offers a claim that is still pending, was rejected, or isn't currently offered to anyone (`unassigned`) to another adjuster. This works exactly like sending a new claim: the new adjuster accepts or rejects it in the app, and `assignment` describes the new offer (`pending_acceptance`, the new `adjust…
- [Invite an adjuster to your firm](https://docs.osaconnection.com/api-reference/adjusters/invite-an-adjuster-to-your-firm.md): Invites an adjuster to your firm by their OSAID. The adjuster sees the invitation in the OSA app, with your firm's name and `invited_as`, and accepts or declines it. Nothing about your claims reaches them until they accept. An invitation that isn't answered expires after 7 days.
- [List your firm's adjusters and invitations](https://docs.osaconnection.com/api-reference/adjusters/list-your-firms-adjusters-and-invitations.md): Lists your firm's adjusters and the invitations you have sent, with their status: `pending`, `active`, `declined`, `expired` or `withdrawn`. An adjuster's `name` and `email` are shown only once they have accepted.
- [Withdraw a pending invitation](https://docs.osaconnection.com/api-reference/adjusters/withdraw-a-pending-invitation.md): Withdraws a pending invitation. The adjuster can no longer accept it, and its status becomes `withdrawn`. You can invite the same adjuster again later.
- [Check your API key](https://docs.osaconnection.com/api-reference/account/check-your-api-key.md): Confirms that your key works and shows the firm it belongs to, whether it is a live or test key, and the permissions it currently carries. Permissions come from your firm's plan and the key's purpose, so they can change without a new key. Any valid key can call this endpoint.
- [Check the service is up](https://docs.osaconnection.com/api-reference/health/check-the-service-is-up.md): Returns `200` when the API is accepting requests. It needs no key and returns no data, so it is safe for uptime monitors.
- [List and poll claims](https://docs.osaconnection.com/api-reference/claims/list-and-poll-claims.md): Lists the claims your firm sent through the API, oldest change first, ordered by `updated_at` and then `id`. This is the endpoint to poll for acceptance: call it every 1 to 5 minutes with `updated_since` rather than polling claims one by one.
- [Send a claim to an adjuster](https://docs.osaconnection.com/api-reference/claims/send-a-claim-to-an-adjuster.md): Creates a claim in your firm and offers it to the adjuster named by `adjuster_osa_id`. The adjuster accepts or rejects it in the OSA app; until then the claim's `assignment.status` is `pending_acceptance`. Poll `GET /v1/claims` to see the outcome.
- [Get a claim](https://docs.osaconnection.com/api-reference/claims/get-a-claim.md): Returns the claim as you sent it, with its current `assignment`. Adjusters' later edits in the app don't change what this endpoint returns.
- [Offer a claim to another adjuster](https://docs.osaconnection.com/api-reference/claims/offer-a-claim-to-another-adjuster.md): Offers a claim that is still pending, was rejected, or isn't currently offered to anyone (`unassigned`) to another adjuster. This works exactly like sending a new claim: the new adjuster accepts or rejects it in the app, and `assignment` describes the new offer (`pending_acceptance`, the new `adjust…
- [Invite an adjuster to your firm](https://docs.osaconnection.com/api-reference/adjusters/invite-an-adjuster-to-your-firm.md): Invites an adjuster to your firm by their OSAID. The adjuster sees the invitation in the OSA app, with your firm's name and `invited_as`, and accepts or declines it. Nothing about your claims reaches them until they accept. An invitation that isn't answered expires after 7 days.
- [List your firm's adjusters and invitations](https://docs.osaconnection.com/api-reference/adjusters/list-your-firms-adjusters-and-invitations.md): Lists your firm's adjusters and the invitations you have sent, with their status: `pending`, `active`, `declined`, `expired` or `withdrawn`. An adjuster's `name` and `email` are shown only once they have accepted.
- [Withdraw a pending invitation](https://docs.osaconnection.com/api-reference/adjusters/withdraw-a-pending-invitation.md): Withdraws a pending invitation. The adjuster can no longer accept it, and its status becomes `withdrawn`. You can invite the same adjuster again later.
- [Check your API key](https://docs.osaconnection.com/api-reference/account/check-your-api-key.md): Confirms that your key works and shows the firm it belongs to, whether it is a live or test key, and the permissions it currently carries. Permissions come from your firm's plan and the key's purpose, so they can change without a new key. Any valid key can call this endpoint.
- [Check the service is up](https://docs.osaconnection.com/api-reference/health/check-the-service-is-up.md): Returns `200` when the API is accepting requests. It needs no key and returns no data, so it is safe for uptime monitors.

## OpenAPI Specs

- [openapi](/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.