> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bridgelinepf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Partner quotes

> For distribution partners: price a deal with a partner API key and get every option at the agency's cost.

These endpoints are for **distribution partners**: wholesalers, MGAs and software platforms that quote premium financing on behalf of the agencies they work with. If you're an agency, start with [quote in one call](https://docs.bridgelinepf.com/guides/quote-in-one-call.md) instead.

A partner API key acts as your partner account. There is no agency and no broker behind it, and the quotes it creates belong to you.

> [!NOTE]
>
> Partner API access is by invitation during the beta. Bridgeline turns it on for your organization; once it is on, you create your own keys.

## Getting a key

You create and revoke keys yourself, in the partner console.

1. Sign in at [portal.bridgelinepf.com/wholesaler/sign-in](https://portal.bridgelinepf.com/wholesaler/sign-in) and open **Settings**, then **API keys**.
2. Choose **Create API key**. Give the key a name, pick test or live, and pick its scopes: `quotes:write` to create quotes, `quotes:read` to read them back.
3. Copy the key. It is shown once, when you create it, and we store only a hash of it. If you lose it, revoke it and create a new one.

Only an admin of your organization can create or revoke a key. Everyone else on your team can see the list: each key's name, its first and last few characters, its mode, when it was created and last used, and whether it is active.

Test keys (`bl_test_`) and live keys (`bl_live_`) are turned on separately, by Bridgeline. A test key prices deals the same way a live key does and keeps its quotes apart from live ones, so it is the place to build. See [test and live mode](https://docs.bridgelinepf.com/concepts/test-and-live-mode.md).

If the API keys tab says access isn't turned on, or a mode can't be chosen when you create a key, that mode is off for your organization: ask your Bridgeline contact. Bridgeline can also turn access off. When that happens every key of that mode stops working at once, and requests made with one return [`403 API_ACCESS_NOT_ENABLED`](https://docs.bridgelinepf.com/errors/API_ACCESS_NOT_ENABLED) for a live key or [`403 TEST_MODE_NOT_ENABLED`](https://docs.bridgelinepf.com/errors/TEST_MODE_NOT_ENABLED) for a test key. The key is not deleted: it works again if access is turned back on, so revoke any key you no longer trust. Revoking works while access is off.

Check a new key with [`GET /v1/partner/whoami`](https://docs.bridgelinepf.com/api-reference/partner/whoami).

## The endpoints

Every partner endpoint starts with `/v1/partner/`.

| Endpoint | Scope | |
| - | - | - |
| `POST /v1/partner/quotes` | `quotes:write` | [Create a partner quote](https://docs.bridgelinepf.com/api-reference/partner/quotes/create.md) |
| `GET /v1/partner/quotes/{id}` | `quotes:read` | [Retrieve a partner quote](https://docs.bridgelinepf.com/api-reference/partner/quotes/retrieve.md) |
| `GET /v1/partner/coverage-types` | None | [List coverage types](https://docs.bridgelinepf.com/api-reference/partner/coverage-types.md) |
| `GET /v1/partner/whoami` | None | [Check a partner API key](https://docs.bridgelinepf.com/api-reference/partner/whoami.md) |

A partner key works only on these endpoints, and an agency key works only on the others. Either mismatch returns [`403 KEY_TYPE_NOT_ALLOWED`](https://docs.bridgelinepf.com/errors/KEY_TYPE_NOT_ALLOWED).

## Create a quote

Send the insured and one or more policies financed together as one loan: the same deal fields an agency sends. There is no `broker_email`, and sending it is a `422`. The [reference page](https://docs.bridgelinepf.com/api-reference/partner/quotes/create.md) lists every field.

```bash theme={null}
curl https://portal.bridgelinepf.com/api/v1/partner/quotes \
  -H "Authorization: Bearer $BRIDGELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "client_reference_id": "SUB-2026-0412",
    "insured": {
      "name": "Lone Star Fabrication LLC",
      "address": {"city": "Houston", "state": "TX", "postal_code": "77002"}
    },
    "policies": [
      {
        "premium": "46100.00",
        "minimum_earned": {"rate": 0.25},
        "effective_date": "2026-10-15",
        "expiration_date": "2027-10-15",
        "carrier": {"name": "Scottsdale Insurance Company", "naic_code": "41297"},
        "coverages": [{"type": "general_liability"}]
      }
    ]
  }'
```

The response is a `partner_quote`: totals, eligibility, assumptions, warnings, binding readiness and every down payment and term we can offer. Eligibility, assumptions and binding readiness mean what they mean on any Bridgeline quote: see [eligibility](https://docs.bridgelinepf.com/concepts/eligibility.md), [assumptions](https://docs.bridgelinepf.com/concepts/assumptions.md) and [binding readiness](https://docs.bridgelinepf.com/concepts/binding-readiness.md). `recommended_option_id` is the option we'd show first.

A deal we can't finance is still a `201` with `eligibility.status: "ineligible"`, its reasons and no options.

## The price is the agency's cost

Every partner quote carries `price_basis: "agency_cost"`. The `apr`, `monthly_payment`, `finance_charge` and totals on each option are what the **agency** pays, before the agency adds its own compensation. They are not the price the insured will see.

Show these figures to the agency you're quoting for, not to the insured as a final offer.

## Your pricing settings

A partner quote is priced using the pricing settings on your partner account, which you manage in your Bridgeline console.

* The API reads those settings. It never changes them and never returns them.
* A deal we can finance is never priced without them. If they can't be read, the request is refused with [`503 SERVICE_UNAVAILABLE`](https://docs.bridgelinepf.com/errors/SERVICE_UNAVAILABLE) and no quote is stored. Wait for `Retry-After`, then retry with the same `Idempotency-Key`. If it keeps happening, your account's settings may need attention: contact Bridgeline.
* A deal we can't finance is answered `201` with `eligibility.status: "ineligible"` whether or not the settings can be read, because nothing is priced.

## What a partner quote doesn't have yet

* **No link.** The response has no link field, and a partner quote has no page to send to anyone. A way to hand a quote on to an agency is planned and is not available yet.
* **No broker and no interest.** There is no `broker`, `hosted_url`, `interest` or `selected_option_id` on a partner quote.
* **No list.** Read a quote back by its id. Store the `id`, or set `client_reference_id` to your own reference.

`status` is `active` until `expires_at` (30 days after the quote is created), then `expired`.

## Reading a quote back

[`GET /v1/partner/quotes/{id}`](https://docs.bridgelinepf.com/api-reference/partner/quotes/retrieve) returns the quote exactly as it was priced. It is never re-priced.

You can read only the quotes your partner account created, with a key of the same mode. Anything else is a [`404`](https://docs.bridgelinepf.com/errors/NOT_FOUND): another partner's quote, an agency's quote, or a live quote read with a test key.

## Test and live

Partner keys come in both modes, and Bridgeline turns each on for your account separately. A `bl_test_` key gets real pricing and real rules, and its quotes are kept apart from live ones. See [test and live mode](https://docs.bridgelinepf.com/concepts/test-and-live-mode.md).

## Limits and retries

* Partner keys have their own [rate limits](https://docs.bridgelinepf.com/guides/rate-limits.md#partner-keys), counted separately from any agency's.
* Send an `Idempotency-Key` on every `POST /v1/partner/quotes`, so a retry after a timeout can't create a second quote. See [idempotency](https://docs.bridgelinepf.com/guides/idempotency.md).


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