Quotes your broker has presented

GET

/submissions/{id}/quotes

curl -X GET "https://api.valjeanspecialty.com/api/agent/v1/submissions/SUBMISSION_ID/quotes" \
  -H "Authorization: Bearer $VALJEAN_KEY"

const res = await fetch("https://api.valjeanspecialty.com/api/agent/v1/submissions/SUBMISSION_ID/quotes", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.VALJEAN_KEY}`, },
});
console.log(await res.json());

import os, requests

res = requests.get(
    "https://api.valjeanspecialty.com/api/agent/v1/submissions/SUBMISSION_ID/quotes",
    headers={"Authorization": f"Bearer {os.environ['VALJEAN_KEY']}"},
)
print(res.json())

Only quotes a broker has presented, never ones still being worked. Totals include fees; surplus lines taxes are added at binding.

Any key (read or read-and-submit).

Authorizations

bearerAuth
apiKeyHeader
oauth2
read

Parameters

Path Parameters

required

string format: uuid

Submission id.

Responses

200

application/json

object

submission_id

required

string format: uuid

quotes

required

Array<object>

object

required

string format: uuid

carrier

required

string

lines

required

Line codes.

Array<string>

premium

required

Dollars.

number

fees

required

Policy, inspection, broker and other fees, in dollars.

number

total

required

Premium plus fees, in dollars. Surplus lines taxes are added at binding.

number

limits

required

string | null

deductibles

required

string | null

exclusions

required

string | null

subjectivities

required

string | null

expires_on

required

string | null format: date

note

required

string

Example

{
  "submission_id": "6f2a1c9e-4b3d-4e8a-9c21-7d4e5f6a8b90",
  "quotes": [
    {
      "id": "6f1d2c3b-8a9e-4b7c-9d10-1e2f3a4b5c6d",
      "carrier": "Magnolia Underwriting Managers",
      "lines": [
        "GL",
        "LL"
      ],
      "premium": 17075,
      "fees": 250,
      "total": 17325,
      "limits": "GL: $1,000,000 per occurrence / $2,000,000 aggregate",
      "deductibles": "GL: $2,500 BI/PD",
      "exclusions": null,
      "subjectivities": "Signed application; currently valued loss runs",
      "expires_on": "2026-12-02"
    }
  ],
  "note": "To bind, reply to your Valjean broker: binding needs a signed request and the subjectivities met."
}

Headers

RateLimit-Policy

string

Example

"per-key";q=120;w=60

The rate limit for this key, as an IETF RateLimit-Policy: 120 requests (q) per 60-second window (w), counted across all of Valjean’s servers. Over it, you get 429 with Retry-After.

401

Key or token missing, wrong, expired or revoked (unauthorized). Don’t retry: get a new key or sign in again.

application/json

object

error

required

object

code

required

Machine-readable code, e.g. invalid_request, read_only, not_found, closed, rate_limited.

string

message

required

Plain-English explanation you can show a person.

string

issues

Validation problems, as “field: problem” (400 invalid_request only).

Array<string>

Example

{
  "error": {
    "code": "unauthorized",
    "message": "This API key isn't valid. Ask your Valjean broker for a new one."
  }
}

403

Not allowed: read_only (a read key tried to submit), agency_not_active (no signed broker agreement), not_offered (instant quotes are off), forbidden (API access off for the agency). Don’t retry.

application/json

object

error

required

object

code

required

Machine-readable code, e.g. invalid_request, read_only, not_found, closed, rate_limited.

string

message

required

Plain-English explanation you can show a person.

string

issues

Validation problems, as “field: problem” (400 invalid_request only).

Array<string>

Example

{
  "error": {
    "code": "read_only",
    "message": "This key can read only. Ask your Valjean broker for a key that can submit."
  }
}

404

Not found, or not your agency’s (not_found). The API never says which.

application/json

object

error

required

object

code

required

Machine-readable code, e.g. invalid_request, read_only, not_found, closed, rate_limited.

string

message

required

Plain-English explanation you can show a person.

string

issues

Validation problems, as “field: problem” (400 invalid_request only).

Array<string>

Example

{
  "error": {
    "code": "not_found",
    "message": "Submission not found."
  }
}

429

Too many requests (rate_limited): 120 a minute per key, 30 a minute per IP on public endpoints, counted across all of Valjean’s servers. Wait Retry-After seconds.

application/json

object

error

required

object

code

required

Machine-readable code, e.g. invalid_request, read_only, not_found, closed, rate_limited.

string

message

required

Plain-English explanation you can show a person.

string

issues

Validation problems, as “field: problem” (400 invalid_request only).

Array<string>

Example

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in a minute."
  }
}

Headers

Retry-After

integer

Example

Seconds to wait.

500

Something went wrong on Valjean’s side (server_error). Safe to retry later; creates are idempotent with client_reference or an Idempotency-Key header.

application/json

object

error

required

object

code

required

Machine-readable code, e.g. invalid_request, read_only, not_found, closed, rate_limited.

string

message

required

Plain-English explanation you can show a person.

string

issues

Validation problems, as “field: problem” (400 invalid_request only).

Array<string>

Example

{
  "error": {
    "code": "server_error",
    "message": "Something went wrong. Try again shortly."
  }
}