For AI agents and developers
GetBrazilDocs for agents: API, MCP and pricing
Plan the documents for a Brazil visa or residence backwards from a deadline, quote them, and hand the person a request link. You can plan, quote and start a draft; only the person can submit, consent and pay. Self-service has no approval step and no checks; with Concierge, Camila Mota checks the documents and approves before any payment.
Preview: the order service runs locally or on a private staging server only. Figures are test or assumed prices; payments are Stripe test mode only.
Start here
- OpenAPI 3.1: /openapi.json (also
/.well-known/openapi.json) - MCP (Streamable HTTP, JSON responses):
POST https://getbrazildocs.com/mcp. Server card: /.well-known/mcp/server-card.json - Pricing: /pricing.json · Services: /services.json · llms.txt · llms-full.txt
- Rules: agent policy. No auth during the preview. Send
X-Agent-Name.
How prices are calculated
Each service is partner cost shown at cost, line by line (partner fee, courier where the service ships paper, any official fee we pass through), plus our service fee of 10% of that service's partner cost, minimum US$30 per service. Kits are bundles: their total is the sum of their services. Two service levels: self-service (the services only, online, with NO checks: you choose, confirm that nobody from GetBrazilDocs checks your documents, pay and upload; we forward your documents to the providers as they are) or concierge (+ US$99 flat per order, not marked up: Camila Mota checks your documents and approves before you pay, replying within 24 hours; then we manage everything, with calendar invites and requests for action). Price on request: other document types (for example a criminal record from another country) are described in a text box, never priced in the total, and quoted by hand by Camila Mota within 24 hours at either level.
Service fee = max(US$30, 10% × partner cost of that service). Where a service ships paper, the courier sits in its partner cost and is shown as its own at-cost line. FBI services include the digital copy at no extra fee; the paper original by DHL is its own optional service (paper-original). Official fees already inside a partner fee are listed as included and not added again. Worked examples on the current test and assumed costs (test prices):
| Service | Partner cost (at cost) | Service fee | Total | Flags |
|---|---|---|---|---|
fbi-apostilleFBI check + US State Department apostille | US$140 | US$30 (minimum) | US$170 | partner-stated |
fbi-apostille-expressFBI check + US State Department apostille, express handling | US$190 | US$30 (minimum) | US$220 | partner-stated |
apostille-onlyUS State Department apostille of your FBI result | US$129 | US$30 (minimum) | US$159 | partner-stated |
paper-originalPaper original by courier to Brazil (optional add-on) | US$95 | US$30 (minimum) | US$125 | partner-stated |
sworn-translationSworn translation into Portuguese (1 page) | US$19.23 | US$30 (minimum) | US$49.23 | assumed-cost, fx-assumed |
notary-contractRemote notarization and apostille of a contract | US$165 | US$30 (minimum) | US$195 | fx-assumed |
contract-courierNotarized contract original by DHL to Brazil (optional add-on) | US$99 | US$30 (minimum) | US$129 | fx-assumed |
Service levels: Self-service (no flat fee: Choose, pay and upload online. Nobody checks your documents.) or Concierge (US$99 flat per order, not marked up: Camila checks your documents; we manage everything for you.) Nothing is charged until Camila approves your request (we reply within 24 hours). The concierge fee is part of the single locked quote you pay after approval.
We place and pay every partner order ourselves, under the GetBrazilDocs name (white-label: no partner payment links, and provider names are never shown). At both levels you deal only with GetBrazilDocs ([email protected]).
Digital copy and paper original
Digital copy, included in every FBI service at no extra fee: A color PDF scan of the apostilled FBI check, emailed on the day the apostilled paper is collected from the State Department. Use it to file on MigranteWeb (the Polícia Federal online residence filing) and to start the sworn translation. This is a convenience scan, not an official e-apostille: the US State Department apostilles paper only. The Polícia Federal may still ask for the paper original (especially at the CRNM registration appointment), and consulates may require originals. "Same-day" means the scan is emailed on collection day. It does not describe the whole FBI and apostille process. Paper original by DHL: recommended for criminal records on every channel, including MigranteWeb, because most filings end at a Polícia Federal appointment where the original must be shown (courier at cost, US$95 on the default route, plus our service fee of max(US$30, 10%)), 2–5 days after collection (partner estimate). Digital PDF only is the cheaper option: cheaper, but the PF may ask to see the original at your appointment. Quick path: file on MigranteWeb from the digital copy without waiting for the paper. The apostilled work contract needs no physical copy: its DHL original (90 EUR at cost + our fee) is an optional add-on, off by default (item contract-courier or contractPaperOriginal: true).
Planner payloads carry milestones (digital-copy: digital copy ready, file on MigranteWeb; paper-original: paper original in Brazil), quickSubmission and paperOriginal (recommended / selected). Quotes carry digitalCopy and paperOriginal. Send paperOriginal: true to add the paper.
REST endpoints
| Method | Path | What |
|---|---|---|
| POST | /api/v1/planner | Plan backwards from a submit date (stateless). |
| POST | /api/v1/estimates | Itemized quote for bundles; serviceLevel=concierge adds the flat concierge fee (stateless). |
| GET | /api/v1/pricing | Fee policy, worked examples per service, service levels, official fees. |
| GET | /api/v1/pricing/services/{serviceId}?pages=N | Price ONE service (same engine as quotes). |
| GET | /api/v1/services | Services, what each includes, limits. |
| GET | /api/v1/tools/fbi-validity-clock | Is an FBI result still in date on the submit date? |
| GET | /api/v1/tools/fbi-route-checker | eDO or channeler, prints, apostille type, mail legs. |
| GET | /api/v1/tools/translation-cost | Sworn translation pages and cost estimate. |
| POST | /api/v1/order-intents | Start a draft request for a human to submit. Returns a request link. Self-service: no approval step (the person confirms nobody checks their documents). Concierge: Camila Mota approves before payment. |
| GET | /api/v1/orders/{token} | Read-only order status. |
MCP tools
plan_deadlineestimate_quoteprice_servicefbi_validity_clockfbi_route_checkertranslation_cost_estimatecreate_order_intentget_order_status
create_order_intent only starts a draft and returns a link for the person. It never submits, consents, uploads or pays.
Order flow
- You start a draft (status
draft) and give the person therequestUrl. You may prefill nationality and key dates. - The person adds key dates, nationality and the passport photo page (required), accepts the terms and submits. No payment yet.
- Self-service: the person must also tick that nobody from GetBrazilDocs checks their documents (stored with a timestamp; the server refuses submit and checkout without it). The quote is then locked straight away (
approved, decisionauto_locked): no approval, no review. - Concierge: the request is
submittedand Camila Mota checks the documents, replying within 24 hours:approved(quote locked, Stripe test-mode pay link valid 7 days),changes_requested(the person updates and resubmits) ordeclined. - Price-on-request items (other document types) are never in the total: Camila quotes them by hand, at either level.
- The person pays the locked quote (
paid). An unpaid quote becomesexpiredafter 7 days. No provider work before payment. - We place the provider orders ourselves, under the GetBrazilDocs name. The person uploads documents and answers requests for action on the request page (self-service: forwarded as they are; concierge: Camila checks them, and we email calendar invites, .ics). We track the checklist and email each step through to
delivered. For concierge orders, Camila checks the finished documents before delivery. The person never deals with a provider. Read progress with get_order_status.
Rate limits
Per IP: tools and quotes 60/minute, order intents 10/hour, MCP 120/minute.
Errors
Errors are RFC 9457 problem+json. The type URL points at these anchors.
validation(422)- A field is missing or invalid; `errors` lists each one.
human-only(403)- Consent, submission, uploads or payment were attempted by an agent, or consent / approval / payment fields were sent on an order intent. Only the customer (and, for approval, Camila Mota) can do these.
rate-limit(429)- Too many requests; wait for Retry-After.
not-found(404)- No such endpoint, order or link.
method(405)- Wrong HTTP method for this path.
content-type(415)- Send JSON with Content-Type: application/json.
bad-json(400)- The body is not a JSON object.
too-large(413)- Body or file too large.
not-approved(409)- Payment or checkout was attempted before the quote was locked (Concierge: before Camila Mota approved it). No checkout exists before that.
payment-gate(409)- Partner work was attempted before the locked quote was paid.
quote-expired(409)- The locked quote passed its 7-day payment window. Nothing was charged; it can be re-issued.
internal(500)- Our error. Retry later.