{"openapi":"3.1.0","info":{"title":"Ordering API","version":"1.0.0","description":"Search suppliers, send them a request, receive their quotes, accept one and follow the order. Docs with examples for every operation: https://midgardscience.aramous.com/developers/api. Searching needs no key. To order: get a key by email (POST /api/v1/auth/code with your email, then POST /api/v1/auth/token with the six-digit code from the email) and send it as `Authorization: Bearer mg_...`. A key acts for its email: it sees every request placed with that address, on the website too. The same API is an MCP server for AI agents at https://industrial.midgardsource.com/api/mcp. Limits: every answer from a limited endpoint carries `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (seconds until a call is freed) and `RateLimit-Policy`; a 429 adds `Retry-After`, the seconds to wait. Paging: GET /api/v1/suppliers takes `page` and `per_page` and answers with `total`; GET /api/v1/requests takes `limit` and `starting_after` and answers with `has_more` and `next_starting_after`. Retries: send an `Idempotency-Key` unique to each new request with POST /api/v1/requests. The steps: 1. search (POST /api/v1/search with the work in plain words returns ranked suppliers and a request draft) and upload any files (POST /api/v1/uploads); 2. create a request (POST /api/v1/requests): it starts with status `new`, and GET /api/v1/requests/{id} lists its `suggestions`; 3. fill in what `missing` lists (`set_spec`; a needed field can be marked not known), then say which suppliers to ask (POST /api/v1/requests/{id}/actions with `confirm_labs`): the status becomes `sourcing`, and quote requests are sent to the chosen suppliers that have an email or a quote form. Suppliers are asked to reply by `reply_by`; when one declines or misses it, `next_suppliers` lists who to invite with `invite_more`; 4. wait for status `quoted` (poll the events or set a webhook); 5. accept a quote and say how you continue (POST /api/v1/quotes/{id}/accept with `continue`: `midgard` to keep the order here, `own` to deal with the supplier on your own; or the `choose_managed` and `choose_direct` actions). The supplier does the work and is responsible for it and for its own compliance."},"servers":[{"url":"https://industrial.midgardsource.com"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"A key from POST /api/v1/auth/token or /developers (mg_...). Keys made before mg_ (sk_live_...) still work."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Quote":{"type":"object","properties":{"id":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string"},"turnaround_days":{"type":["integer","null"]},"valid_until":{"type":["string","null"],"format":"date-time"},"terms":{"type":["string","null"]},"status":{"type":"string","enum":["sent","accepted","expired","withdrawn"]},"payment_url":{"type":["string","null"],"description":"Card checkout link once accepted"},"paid":{"type":"boolean"},"ways":{"type":"array","items":{"$ref":"#/components/schemas/QuoteWay"},"description":"GET /api/v1/requests/{id} only. How you can continue with this quote; empty unless the quote is open and the request is `quoted`."}}},"QuoteWay":{"type":"object","properties":{"way":{"type":"string","enum":["own","provider","midgard"],"description":"`own`: deal with the supplier yourself. `provider`: order through the supplier's own ordering service. `midgard`: keep the order here."},"title":{"type":"string"},"label":{"type":"string"},"note":{"type":"string"},"accept":{"type":"object","description":"`own` and `midgard`: the call that takes this way","properties":{"method":{"type":"string"},"path":{"type":"string"},"body":{"type":"object"}}},"url":{"type":"string","description":"`provider`: the page to continue on"},"terms_url":{"type":"string","description":"`midgard`: the order terms"}}},"Message":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","enum":["message"]},"from":{"type":"string","enum":["you","midgard"],"description":"`you`: sent by you. `midgard`: an update or a supplier's question passed on to you."},"message":{"type":"string"},"created_at":{"type":"string","format":"date-time"}}},"SearchResult":{"type":"object","properties":{"object":{"type":"string","enum":["search_result"]},"query":{"type":"string"},"site":{"type":"string","enum":["science","industrial"]},"category":{"type":"string"},"summary":{"type":["string","null"],"description":"A one-line reading of the query, when the model gave one"},"ranked_by":{"type":"string","enum":["model","keywords"]},"scoped_by":{"type":"string","enum":["model","rules"]},"searched":{"type":"object","description":"How many listings were searched, and whether by meaning","properties":{"listings":{"type":"integer"},"by_meaning":{"type":"boolean"}}},"suppliers":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"location":{"type":"object"},"website":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"url":{"type":"string"},"fit":{"type":"string","enum":["strong","possible"],"description":"`strong`: the listing states the work and every standard and place the query requires. `possible`: it states part of it, or the search fell back to keywords (`ranked_by: keywords`)."},"reasons":{"type":"array","items":{"type":"string"},"description":"Taken from the supplier's profile"},"standards":{"type":"array","items":{"type":"string"},"description":"The standards in `certifications` that this site's departments show"},"certifications":{"type":"array","items":{"type":"string"},"description":"Every standard the listing names, as a short tag. GET /api/v1/suppliers/{slug} gives each in the listing's own words, with its scope, under `quality`."},"itar_registered":{"type":["boolean","null"],"description":"True when the listing states it is registered with the US State Department (DDTC) for ITAR work; null when it does not say"},"direct":{"type":["object","null"],"description":"The supplier's own way to order or ask for a quote: `kind`, `href`, and `opens`, what the link opens"},"provider":{"type":["object","null"],"description":"An ordering service that takes orders for this supplier: `key` and `name`"}}}},"request_draft":{"allOf":[{"$ref":"#/components/schemas/NewRequest"}],"description":"Check it, fill in what `missing` lists, then send it to POST /api/v1/requests"},"missing":{"type":"array","description":"Fields to ask about. `not_known_allowed` false: a value is needed to create the request. true: a value or `spec_unknown` before `confirm_labs`.","items":{"type":"object","properties":{"key":{"type":"string"},"question":{"type":"string"},"options":{"type":"array","items":{"type":"string"}},"not_known_allowed":{"type":"boolean"}}}},"questions":{"type":"array","items":{"type":"string"},"description":"Questions to put to the person before the request is placed, in plain words"}}},"Supplier":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"website":{"type":["string","null"]},"description":{"type":["string","null"]},"location":{"type":"object","properties":{"city":{"type":["string","null"]},"region":{"type":["string","null"]},"country":{"type":["string","null"]}}},"sites":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"capabilities":{"type":"array","items":{"type":"string"}},"certifications":{"type":"array","items":{"type":"string"},"description":"Every standard the listing names, as a short tag. GET /api/v1/suppliers/{slug} gives each in the listing's own words, with its scope, under `quality`."},"itar_registered":{"type":["boolean","null"],"description":"True when the listing states it is registered with the US State Department (DDTC) for ITAR work; null when it does not say. `cert=ITAR` matches these listings too."},"logo_url":{"type":["string","null"]},"claimed":{"type":"boolean","description":"The owner confirmed the listing by email or from the company's own domain"},"verified":{"type":"boolean","description":"Signed Midgard's supplier agreement; paid through Midgard"},"badges":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["claimed","verified","aramous_verified"]},"label":{"type":"string"},"meaning":{"type":"string","description":"What the mark means, in plain words."},"checked":{"type":"string","deprecated":true,"description":"The same text as `meaning`, kept for existing clients. Read `meaning`."}}}},"services":{"type":"array","items":{"type":"object"}}}},"Request":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","enum":["request"]},"site":{"type":"string","enum":["science","industrial"]},"category":{"type":"string"},"title":{"type":"string"},"spec":{"type":"object","additionalProperties":{"type":"string"}},"quantity":{"type":["integer","null"]},"details":{"type":["string","null"]},"needed_by":{"type":["string","null"]},"updated_at":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["new","sourcing","quoted","accepted","paid","in_progress","delivered","closed","cancelled","introduced"],"description":"`introduced`: you continued on your own with the supplier; nothing more happens here."},"spec_unknown":{"type":"array","items":{"type":"string"},"description":"Spec keys marked not known; the suppliers say what they would use"},"missing":{"type":"array","items":{"type":"string"},"description":"Needed spec keys still open. `confirm_labs` is refused until each has a value or is in `spec_unknown`."},"reply_by":{"type":["string","null"],"format":"date","description":"The date the suppliers asked are to reply by"},"outcome_reason":{"type":["string","null"],"enum":["price","lead_time","capability","other",null],"description":"The reason shared with the suppliers not chosen"},"late":{"type":"boolean","description":"A step of the order is past its date and not marked done"},"quotes":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}},"labs":{"type":"array","description":"GET /api/v1/requests/{id} only. The suppliers asked.","items":{"type":"object","properties":{"rfq_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"state":{"type":"string"},"sent_at":{"type":["string","null"],"format":"date-time"},"reply_by":{"type":["string","null"],"format":"date-time","description":"This supplier's reply-by deadline"},"decline_reason":{"type":["string","null"],"description":"When it declined: full, not_our_work, need_info or other"}}}},"next_suppliers":{"type":"array","description":"GET /api/v1/requests/{id} only, and only after a supplier declined, missed `reply_by` or could not be reached: the next best matches for `invite_more`.","items":{"type":"object","properties":{"supplier_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}}}}},"suggestions":{"type":"array","description":"GET /api/v1/requests/{id} only. The suppliers suggested for this request; `supplier_id` is what `confirm_labs` takes in `supplierIds`. `picked`: pre-selected.","items":{"type":"object","properties":{"supplier_id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"picked":{"type":"boolean"}}}},"milestones":{"type":"array","items":{"$ref":"#/components/schemas/Milestone"},"description":"GET /api/v1/requests/{id} only"},"mode":{"type":["string","null"],"enum":["managed","direct",null],"description":"GET /api/v1/requests/{id} only. Once a quote is accepted: `managed`, kept here; `direct`, continued with the supplier on your own"},"scope_of_work":{"type":"array","items":{"type":"object"},"description":"GET /api/v1/requests/{id} only"},"change_orders":{"type":"array","items":{"type":"object"},"description":"GET /api/v1/requests/{id} only"},"payments":{"type":"array","items":{"type":"object"},"description":"GET /api/v1/requests/{id} only"},"shipments":{"type":"array","items":{"type":"object"},"description":"GET /api/v1/requests/{id} only"},"files":{"type":"array","items":{"type":"object"},"description":"GET /api/v1/requests/{id} only"},"events":{"type":"array","items":{"type":"object"},"description":"GET /api/v1/requests/{id} only. The public timeline, oldest first"},"created_at":{"type":"string","format":"date-time"}}},"CreatedRequest":{"allOf":[{"$ref":"#/components/schemas/Request"},{"type":"object","properties":{"status_url":{"type":["string","null"],"description":"A page a person can open to follow the request"}}}]},"Milestone":{"type":"object","properties":{"stage":{"type":"string"},"planned_at":{"type":["string","null"],"format":"date-time","description":"The date first agreed"},"expected_at":{"type":["string","null"],"format":"date-time","description":"The current date"},"done_at":{"type":["string","null"],"format":"date-time"},"state":{"type":"string","enum":["done","late","delayed","on_track","open"],"description":"`late`: past its date, not done. `delayed`: the supplier moved the date. `on_track`: the supplier confirmed it."},"waiting_on":{"type":["string","null"],"enum":["supplier","buyer",null],"description":"`buyer`: you can move its date with `set_milestone_date`"},"delay_reason":{"type":["string","null"]},"checked_in_at":{"type":["string","null"],"format":"date-time"},"note":{"type":["string","null"]}}},"NewRequest":{"type":"object","required":["site","category","title"],"properties":{"site":{"type":"string","enum":["science","industrial"]},"category":{"type":"string","enum":["assays","protein-production","dmpk-tox","cell-line-development","sequencing","biologics-manufacturing","custom-peptides","compounds","cnc-machining","sheet-metal","3d-printing","pcb","finishing","testing-inspection","metals","plastics","chemicals-coatings","packaging","components"],"description":"See GET /api/v1/categories for each category's spec fields"},"title":{"type":"string","maxLength":160},"spec":{"type":"object","additionalProperties":{"type":"string","maxLength":2000},"description":"The category's spec fields (GET /api/v1/categories), key to text value. A `select` field takes one of its `options`; a `file` field takes the `url` from POST /api/v1/uploads; a `number` field is sent as text too, e.g. \"12\"."},"spec_unknown":{"type":"array","items":{"type":"string"},"maxItems":40,"description":"Spec keys the person does not know. Needed fields must have a value or be listed here before `confirm_labs`."},"quantity":{"type":["integer","null"],"minimum":1,"description":"How many, counted in the category's `unit` from GET /api/v1/categories (samples, parts, ...)"},"needed_by":{"type":["string","null"],"description":"A date, e.g. 2027-01-15"},"budget":{"type":"string","maxLength":60,"description":"Shown to the suppliers asked"},"details":{"type":["string","null"]},"supplier":{"type":"string","description":"Preferred supplier slug (optional)"},"suppliers":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Supplier slugs to pre-select. Nobody is asked until `confirm_labs`; a slug this site does not list is refused."},"email":{"type":"string","format":"email","description":"The key's own email. Leave it out; any other address is refused."},"organization":{"type":"string"},"country":{"type":"string"}}}}},"paths":{"/api/v1/auth/code":{"post":{"summary":"Email a six-digit sign-in code","description":"The code works once, for 10 minutes, with 5 tries. Asking again sends a new code; the two newest work.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","description":"The address the key will act for."}}}}}},"responses":{"200":{"description":"Sent","content":{"application/json":{"example":{"sent":true,"email":"you@company.com","expires_in":600,"message":"Check you@company.com for a six-digit code."}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: Not an email address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: Too many codes from this network, or for this address. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"authCode","tags":["Keys"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#auth-code","description":"Docs. MCP tool: sign_in"}}},"/api/v1/auth/token":{"post":{"summary":"Trade the code for an API key","description":"The key is shown once. Anyone with it can order as you, so keep it secret.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","code"],"properties":{"email":{"type":"string","format":"email","description":"The same address."},"code":{"type":"string","pattern":"^[0-9]{6}$","description":"The six digits from the email."},"label":{"type":"string","maxLength":80,"description":"A name for the key, e.g. the tool that uses it"}}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["api_key"]},"key":{"type":"string","description":"mg_..., shown once"},"key_id":{"type":"string"},"prefix":{"type":"string"},"email":{"type":"string"}}},"example":{"object":"api_key","key":"mg_…","key_id":"key_Pc5uF3nJ8hV2","prefix":"mg_ab12cd","email":"you@company.com"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: No email or no code. `invalid_code`: The code is wrong. `code_expired`: The code has expired or was used; ask for a new one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`too_many_tries`: Too many wrong codes for this address; try again tomorrow. `rate_limited`: More than 30 tries an hour from this network. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"authToken","tags":["Keys"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#auth-token","description":"Docs. MCP tool: verify_code"}}},"/api/v1/me":{"get":{"summary":"The email this key acts for, the key and its webhook","security":[{"bearer":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"object":"me","email":"you@company.com","key":{"id":"key_Pc5uF3nJ8hV2","prefix":"mg_ab12cd","label":"ERP","created_at":"2026-11-17T09:00:00.000Z","last_used_at":"2026-11-17T09:00:00.000Z"},"webhook_url":null}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"me","tags":["Keys"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#me","description":"Docs. MCP tool: whoami"}}},"/api/v1/keys":{"get":{"summary":"This email's keys (prefix and label only); `current` marks the key in use","security":[{"bearer":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"object":"list","data":[{"object":"api_key","id":"key_Pc5uF3nJ8hV2","prefix":"mg_ab12cd","label":"ERP","created_at":"2026-11-17T09:00:00.000Z","last_used_at":"2026-11-17T09:00:00.000Z","current":true}]}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"listKeys","tags":["Keys"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#list-keys","description":"Docs"}}},"/api/v1/keys/{id}":{"delete":{"summary":"Revoke a key","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"A key id from GET /api/v1/keys."}],"responses":{"200":{"description":"Revoked","content":{"application/json":{"example":{"object":"api_key","id":"key_Pc5uF3nJ8hV2","revoked":true}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`not_found`: No key with that id for this email.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"revokeKey","tags":["Keys"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#revoke-key","description":"Docs"}}},"/api/v1/search":{"post":{"summary":"Find suppliers for work described in plain words","description":"Returns suppliers ranked by fit, each with the reasons from its profile, and a request draft for POST /api/v1/requests. No key needed: 10 searches an hour per address, 100 an hour with a key. Takes up to a minute.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":6,"maxLength":3000,"description":"The work: what, how many, standards, deadlines."},"site":{"type":"string","enum":["science","industrial"],"description":"Defaults to the site this host serves"},"category":{"type":"string","enum":["assays","protein-production","dmpk-tox","cell-line-development","sequencing","biologics-manufacturing","custom-peptides","compounds","cnc-machining","sheet-metal","3d-printing","pcb","finishing","testing-inspection","metals","plastics","chemicals-coatings","packaging","components"],"description":"Leave it out to let the search choose"},"region":{"type":"string","enum":["any","na","us","eu","india","asia"],"description":"Region key. `eu` includes the UK."},"standard":{"type":"string","description":"Only suppliers whose listing names this standard, e.g. GLP"},"limit":{"type":"integer","minimum":1,"maximum":10,"default":8,"description":"Default 8."}}},"examples":{"pk":{"summary":"A PK study","value":{"query":"Mouse PK study for 3 small-molecule compounds, non-GLP, with LC-MS/MS bioanalysis","limit":5}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"},"example":{"object":"search_result","query":"Mouse PK study for 3 small-molecule compounds, non-GLP, with LC-MS/MS bioanalysis","site":"science","category":"dmpk-tox","summary":null,"ranked_by":"model","scoped_by":"model","searched":{"listings":1771,"by_meaning":true},"suppliers":[{"slug":"example-lab","name":"Example Lab","location":{"city":"Boston","region":"MA","country":"US"},"website":"https://lab.example.com","logo_url":null,"url":"https://midgardscience.aramous.com/s/example-lab","fit":"strong","reasons":["Its profile lists this service."],"standards":["ISO 17025"],"certifications":["ISO 17025"],"direct":{"kind":"form","href":"https://lab.example.com/quote","opens":"form"},"provider":null}],"request_draft":{"site":"science","category":"dmpk-tox","title":"Mouse PK study with LC-MS/MS bioanalysis","spec":{"study":"PK study (in vivo)","compounds":"3 small-molecule compounds","species":"Mouse","glp":"Non-GLP"},"quantity":3,"needed_by":null,"details":"Mouse PK study for 3 small-molecule compounds, non-GLP, with LC-MS/MS bioanalysis","suppliers":["example-lab"],"spec_unknown":[]},"missing":[{"key":"route","question":"Route?","options":[],"not_known_allowed":true}],"questions":[]}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_json`: The body is not a JSON object. `invalid_request`: query too short or too long; unknown site, category or region; limit out of range. The message names the field.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"`unauthorized`: A key was sent and is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"`rate_limited`: Over the hourly limit. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}},"500":{"description":"`server_error`: The search failed; try again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}}},"operationId":"search","tags":["Directory"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#search","description":"Docs. MCP tool: find_suppliers"},"security":[{},{"bearer":[]}]}},"/api/v1/suppliers/{slug}":{"get":{"summary":"One supplier: profile, services and prices, standards, shared contact addresses and the ways to continue","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"From a search."}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"object":"supplier","slug":"example-lab","name":"Example Lab","website":"https://lab.example.com","description":"Contract lab for in vitro assays.","location":{"city":"Boston","region":"MA","country":"US","address":null},"sites":["science"],"categories":["assays"],"capabilities":[],"certifications":["ISO 17025"],"itar_registered":null,"logo_url":null,"claimed":false,"verified":false,"badges":[],"services":[{"category":"assays","name":"Assays & in vitro testing","price_from":null,"price_to":null,"currency":"USD","price_unit":null,"turnaround_days":[null,null],"accepts_po":null}],"url":"https://midgardscience.aramous.com/s/example-lab","company_type":null,"founded":null,"team":null,"partner":false,"standards":["ISO 17025"],"offers":[{"name":"Assays & in vitro testing","description":null}],"scope":{},"ordering":{},"quality":[],"sites_listed":[],"regions_served":[],"order_route":null,"contacts":[{"email":"info@example.com","source_url":"https://lab.example.com/contact"}],"ways":[{"way":"midgard","title":"Through Midgard","label":"Request a quote through Midgard","note":"Midgard sends your request to the lab and keeps the order's messages, papers and payments in one place. Free to ask. 1% platform fee if you keep the order on Midgard.","request":{"method":"POST","path":"/api/v1/requests","body":{"suppliers":["example-lab"]}}}],"records":{"glp":null,"ownership":null,"fda_fei":null,"clia":null}}}}},"404":{"description":"`not_found`: No listed supplier with that slug on this site.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"getSupplier","tags":["Directory"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#get-supplier","description":"Docs. MCP tool: get_supplier"}}},"/api/v1/categories":{"get":{"summary":"Sites, categories and spec fields","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"object":"list","data":[{"site":"science","name":"Midgard Science","categories":[{"slug":"assays","name":"Assays & in vitro testing","unit":"samples","spec":[{"key":"assay","label":"Assay or readout","type":"text","required":true,"needed":false,"recommended":false,"when":null,"checklist":false},{"key":"sample_type","label":"Sample type","type":"text","required":false,"needed":true,"recommended":false,"when":null,"checklist":false},{"key":"samples","label":"Samples","type":"select","options":["We ship samples to the lab","Lab sources the material","Not sure"],"required":false,"needed":false,"recommended":false,"when":null,"checklist":false},{"key":"files","label":"Protocol or sample sheet","type":"file","required":false,"needed":false,"recommended":false,"when":null,"checklist":false}]}]}]}}}}},"operationId":"categories","tags":["Directory"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#categories","description":"Docs. MCP tool: list_categories"}}},"/api/v1/openapi.json":{"get":{"summary":"This OpenAPI description","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"openapi":"3.1.0","info":{"title":"Ordering API","version":"1.0.0"},"servers":[{"url":"https://midgardscience.aramous.com"}],"paths":{}}}}}},"operationId":"openapi","tags":["Directory"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#openapi","description":"Docs"}}},"/api/v1/suppliers":{"get":{"summary":"Listed suppliers","parameters":[{"name":"site","in":"query","schema":{"type":"string","enum":["science","industrial"]},"description":"Defaults to the site this host serves"},{"name":"category","in":"query","schema":{"type":"string","enum":["assays","protein-production","dmpk-tox","cell-line-development","sequencing","biologics-manufacturing","custom-peptides","compounds","cnc-machining","sheet-metal","3d-printing","pcb","finishing","testing-inspection","metals","plastics","chemicals-coatings","packaging","components"]},"description":"A category slug of that site."},{"name":"q","in":"query","schema":{"type":"string","maxLength":200},"description":"Words to search for"},{"name":"region","in":"query","schema":{"type":"string"},"description":"A state or province code as listings give it, e.g. CA or OH"},{"name":"cert","in":"query","schema":{"type":"string"},"description":"Only suppliers whose listing names this standard, e.g. ISO 9001"},{"name":"po","in":"query","schema":{"type":"string","enum":["1"]},"description":"Only suppliers that take purchase orders"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"Default 1."},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Default 50."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Supplier"}}}},"example":{"object":"list","total":1,"page":1,"per_page":5,"data":[{"slug":"example-lab","name":"Example Lab","website":"https://lab.example.com","description":"Contract lab for in vitro assays.","location":{"city":"Boston","region":"MA","country":"US"},"sites":["science"],"categories":["assays"],"capabilities":[],"certifications":["ISO 17025"],"itar_registered":null,"logo_url":null,"claimed":false,"verified":false,"badges":[],"services":[{"category":"assays","name":"Assays & in vitro testing","price_from":null,"price_to":null,"currency":"USD","price_unit":null,"turnaround_days":[null,null],"accepts_po":null}]}]}}}},"400":{"description":"`invalid_request`: page or per_page out of range; unknown site; a category of another site.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"listSuppliers","tags":["Directory"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#list-suppliers","description":"Docs. MCP tool: search_suppliers"}}},"/api/v1/requests":{"post":{"summary":"Create a request","security":[{"bearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"description":"Retries with the same key and the same body return the request already created; the same key with any change to the body is refused with 409 `idempotency_conflict`"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewRequest"}}}},"responses":{"200":{"description":"A retry with an `Idempotency-Key` already used by this key: the request it created, with the header `Idempotent-Replayed: true`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedRequest"}}},"headers":{"Idempotent-Replayed":{"description":"`true` on a retry answered with the request already created","schema":{"type":"string","enum":["true"]}},"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedRequest"},"example":{"id":"req_Xq3v9KpL2aB7","object":"request","site":"science","category":"assays","title":"IC50 for 40 compounds in a kinase assay","spec":{"assay":"IC50 against a 10-kinase panel","sample_type":"small molecules in DMSO","replicates":"Triplicate","controls":"vehicle and staurosporine on every plate"},"spec_unknown":[],"missing":[],"quantity":40,"details":null,"needed_by":"2027-01-15","reply_by":null,"outcome_reason":null,"status":"new","created_at":"2026-11-17T09:00:00.000Z","updated_at":"2026-11-17T09:00:00.000Z","quotes":[],"status_url":"https://midgardscience.aramous.com/r/req_Xq3v9KpL2aB7?t=…"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_json`: The body is not a JSON object. `invalid_request`: An unknown site or category, a missing required field, a `select` value that is not one of its options, a placeholder value, or an `email` other than the key's. The message names the field and, for a select, its options.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"`idempotency_conflict`: The Idempotency-Key was already used with a different body. Send a new key for a new request; a retry sends the same body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}},"500":{"description":"`server_error`: The request could not be created; retry with the same Idempotency-Key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}}},"operationId":"createRequest","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#create-request","description":"Docs. MCP tool: create_request"}},"get":{"summary":"Your requests, newest first","description":"Requests placed with this key or by its email on the website. To page, pass `next_starting_after` as `starting_after`.","security":[{"bearer":[]}],"parameters":[{"name":"status","in":"query","schema":{"type":"string"},"description":"One status or several, comma-separated, e.g. `quoted,accepted`"},{"name":"site","in":"query","schema":{"type":"string","enum":["science","industrial"]},"description":"Only this site's requests."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100},"description":"Default 100."},{"name":"starting_after","in":"query","schema":{"type":"string"},"description":"The last request id of the previous page"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"data":{"type":"array","items":{"$ref":"#/components/schemas/Request"}},"has_more":{"type":"boolean"},"next_starting_after":{"type":["string","null"]}}},"example":{"object":"list","data":[{"id":"req_Xq3v9KpL2aB7","object":"request","site":"science","category":"assays","title":"IC50 for 40 compounds in a kinase assay","spec":{"assay":"IC50 against a 10-kinase panel","sample_type":"small molecules in DMSO","replicates":"Triplicate","controls":"vehicle and staurosporine on every plate"},"spec_unknown":[],"missing":[],"quantity":40,"details":null,"needed_by":"2027-01-15","reply_by":"2026-11-24","outcome_reason":null,"status":"quoted","created_at":"2026-11-17T09:00:00.000Z","updated_at":"2026-11-17T09:00:00.000Z","quotes":[],"late":false}],"has_more":false,"next_starting_after":null}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: An unknown status or site, limit out of range, or a starting_after id that is not yours.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"listRequests","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#list-requests","description":"Docs. MCP tool: list_requests"}}},"/api/v1/requests/{id}":{"get":{"summary":"Status, quotes and timeline","description":"Also returns `files`: every file on the order. Each has `from` (`supplier` or `client`) and `kind`. A file the supplier delivered has kind `lab_result` on every kind of order; one of the order's papers has kind `paper`. `labs` lists the suppliers asked, each with its `reply_by` and, when it declined, `decline_reason`. `next_suppliers` appears after a supplier declines or misses its reply-by date. Each milestone has its `state` and who it is `waiting_on`.","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"req_..."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request"},"example":{"id":"req_Xq3v9KpL2aB7","object":"request","site":"science","category":"assays","title":"IC50 for 40 compounds in a kinase assay","spec":{"assay":"IC50 against a 10-kinase panel","sample_type":"small molecules in DMSO","replicates":"Triplicate","controls":"vehicle and staurosporine on every plate"},"spec_unknown":[],"missing":[],"quantity":40,"details":null,"needed_by":"2027-01-15","reply_by":"2026-11-24","outcome_reason":null,"status":"quoted","created_at":"2026-11-17T09:00:00.000Z","updated_at":"2026-11-17T09:00:00.000Z","quotes":[{"id":"qt_Hn4sD8wQ1zR6","object":"quote","price":4800,"currency":"USD","turnaround_days":15,"valid_until":"2026-12-17T00:00:00.000Z","terms":null,"status":"sent","payment_url":null,"paid":false,"lab":{"slug":"example-lab","name":"Example Lab"},"lab_price":4800,"fee":null,"shipping":null,"schedule":null,"ways":[{"way":"own","accept":{"method":"POST","path":"/api/v1/quotes/qt_Hn4sD8wQ1zR6/accept","body":{"continue":"own"}}}]}],"late":false,"mode":null,"scope_of_work":[],"suggestions":[{"supplier_id":"sup_Tb6yE2mC9kW1","slug":"example-lab","name":"Example Lab","reasons":["Its profile lists this service."],"picked":true}],"labs":[{"rfq_id":"rfq_Gd8kM1sP5tY3","slug":"example-lab","name":"Example Lab","status":"quoted","state":"quoted","sent_at":"2026-11-17T09:00:00.000Z","reply_by":"2026-11-24T23:59:59.000Z","decline_reason":null}],"milestones":[{"stage":"kickoff","planned_at":"2026-11-20T00:00:00.000Z","expected_at":"2026-11-24T00:00:00.000Z","done_at":null,"state":"delayed","waiting_on":"supplier","delay_reason":"Waiting on a reagent lot","checked_in_at":"2026-11-17T09:00:00.000Z","note":null}],"change_orders":[],"payments":[],"shipments":[],"files":[],"events":[{"type":"status","status":"quoted","message":"Quoted","created_at":"2026-11-17T09:00:00.000Z"}]}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`not_found`: No request with that id for this key's email.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"getRequest","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#get-request","description":"Docs. MCP tool: get_request"}}},"/api/v1/requests/{id}/events":{"get":{"summary":"Public timeline, oldest first","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"req_..."},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only events after this time"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"object":"list","request_status":"quoted","data":[{"id":"evt_Rw7cN2hK6pQ4","type":"status","status":"quoted","message":"Quoted","created_at":"2026-11-17T09:00:00.000Z"}]}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`not_found`: No request with that id for this key's email.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"events","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#events","description":"Docs"}}},"/api/v1/requests/{id}/messages":{"get":{"summary":"The message thread, oldest first","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"req_..."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"]},"request_id":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Message"}}}},"example":{"object":"list","request_id":"req_Xq3v9KpL2aB7","data":[{"id":"evt_Ys1fV8bT3mD5","object":"message","from":"you","message":"Samples ship on Monday.","created_at":"2026-11-17T09:00:00.000Z"}]}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`not_found`: No request with that id for this key's email.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"messages","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#messages","description":"Docs. MCP tool: get_messages"}},"post":{"summary":"Send a message on a request (answers, extra detail)","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"req_..."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","maxLength":4000,"description":"The text."}}}}}},"responses":{"201":{"description":"Sent","content":{"application/json":{"example":{"object":"message","request_id":"req_Xq3v9KpL2aB7","message":"Samples ship on Monday."}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: No message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`not_found`: No request with that id for this key's email.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"sendMessage","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#send-message","description":"Docs. MCP tool: send_message"}}},"/api/v1/requests/{id}/actions":{"post":{"summary":"Act on a request: choose suppliers, choose a quote, pay, accept the order","description":"One body per action; the schema lists each. snake_case field names are read too. `confirm_labs` (status `new` only) sends the request to the suppliers named by `supplierIds` (ids from the request's `suggestions`) or `slugs` (from GET /api/v1/suppliers), asking them to reply by `replyBy`; it is refused while `missing` lists needed fields. `set_spec` (status `new`) fills spec fields or marks them not known. `invite_more` (status `sourcing` or `quoted`) sends the request to more suppliers from `next_suppliers`. `set_milestone_date` moves the date of a step that waits on you. `set_acceptance` records what the order must meet before quotes are compared. `answer_question` answers a supplier's question. `choose_managed` accepts a quote and keeps the order here under the order terms; `choose_direct` takes the quote to the supplier on your own. Both take an optional `outcomeReason`. `add_shipment` records what you are sending to the supplier. `pay` returns a card payment link for a payment that is due. `decide_change` approves or declines a change. `accept_results` accepts the delivered order; `request_rerun` raises an issue with it. `request_release` gives notice to leave on a storage order.","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"req_..."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"confirm_labs","description":"Send the request to these suppliers. Status `new` only. Give `supplierIds` or `slugs`. Refused while `missing` lists needed fields.","required":["action"],"properties":{"action":{"type":"string","enum":["confirm_labs"],"description":"`confirm_labs`: Send the request to these suppliers. Status `new` only. Give `supplierIds` or `slugs`. Refused while `missing` lists needed fields."},"supplierIds":{"type":"array","items":{"type":"string"},"maxItems":12,"description":"Ids from the request's `suggestions`"},"slugs":{"type":"array","items":{"type":"string"},"maxItems":12,"description":"Slugs from GET /api/v1/suppliers"},"replyBy":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The date suppliers are asked to reply by, 2 to 30 days from today. Default: 5 business days."}}},{"type":"object","title":"invite_more","description":"Send the request to more suppliers while quotes are coming in. Status `sourcing` or `quoted`. Up to 12 suppliers per request.","required":["action","supplierIds"],"properties":{"action":{"type":"string","enum":["invite_more"],"description":"`invite_more`: Send the request to more suppliers while quotes are coming in. Status `sourcing` or `quoted`. Up to 12 suppliers per request."},"supplierIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":3,"description":"Ids from the request's `next_suppliers`"}}},{"type":"object","title":"set_spec","description":"Fill in spec fields or mark them not known. Status `new` only.","required":["action"],"properties":{"action":{"type":"string","enum":["set_spec"],"description":"`set_spec`: Fill in spec fields or mark them not known. Status `new` only."},"spec":{"type":"object","additionalProperties":{"type":"string","maxLength":2000},"description":"Spec key to value; only the category's fields are kept"},"specUnknown":{"type":"array","items":{"type":"string"},"maxItems":40,"description":"Spec keys the person does not know; the suppliers say what they would use"}}},{"type":"object","title":"set_milestone_date","description":"Move the date of a step that waits on you (a milestone whose `waiting_on` is `buyer`). The supplier is told.","required":["action","stage","date"],"properties":{"action":{"type":"string","enum":["set_milestone_date"],"description":"`set_milestone_date`: Move the date of a step that waits on you (a milestone whose `waiting_on` is `buyer`). The supplier is told."},"stage":{"type":"string","maxLength":40,"description":"The milestone's `stage`"},"date":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The new date, YYYY-MM-DD"}}},{"type":"object","title":"set_acceptance","description":"What the order must meet, agreed before quotes are compared.","required":["action","acceptance"],"properties":{"action":{"type":"string","enum":["set_acceptance"],"description":"`set_acceptance`: What the order must meet, agreed before quotes are compared."},"acceptance":{"type":"object","additionalProperties":{"type":"string","maxLength":300},"description":"Term name to its value"}}},{"type":"object","title":"answer_question","description":"Answer a supplier's question.","required":["action","rfqId","answer"],"properties":{"action":{"type":"string","enum":["answer_question"],"description":"`answer_question`: Answer a supplier's question."},"rfqId":{"type":"string","description":"The `rfq_id` of the supplier that asked, from the request's `labs`"},"answer":{"type":"string","minLength":2,"maxLength":1500,"description":"The answer, passed to that supplier"}}},{"type":"object","title":"choose_managed","description":"Accept a quote and keep the order here under the order terms. A 1% platform fee is added as its own line.","required":["action","quoteId","termsName"],"properties":{"action":{"type":"string","enum":["choose_managed"],"description":"`choose_managed`: Accept a quote and keep the order here under the order terms. A 1% platform fee is added as its own line."},"quoteId":{"type":"string","description":"A quote on this request (qt_...)"},"termsName":{"type":"string","minLength":2,"maxLength":120,"description":"The name of the person accepting the order terms"},"po":{"type":"string","maxLength":80,"description":"Purchase order number. With one, payments are invoiced."},"billingEmail":{"type":"string","format":"email","description":"Where invoices go, if not the key's email"},"revision":{"type":"string","maxLength":20,"description":"Parts: the file revision the order is built to, e.g. Rev C"},"outcomeReason":{"type":"string","enum":["price","lead_time","capability","other"],"description":"Optional. The main reason the other suppliers were not chosen; they are told it, never who was chosen or at what price."}}},{"type":"object","title":"choose_direct","description":"Take a quote to the supplier on your own. Free. Your contact details go to the supplier; theirs appear on the timeline.","required":["action","quoteId"],"properties":{"action":{"type":"string","enum":["choose_direct"],"description":"`choose_direct`: Take a quote to the supplier on your own. Free. Your contact details go to the supplier; theirs appear on the timeline."},"quoteId":{"type":"string","description":"A quote on this request (qt_...)"},"outcomeReason":{"type":"string","enum":["price","lead_time","capability","other"],"description":"Optional. The main reason the other suppliers were not chosen; they are told it, never who was chosen or at what price."}}},{"type":"object","title":"add_shipment","description":"Record what you are sending to the supplier. Only on an order kept here.","required":["action","material"],"properties":{"action":{"type":"string","enum":["add_shipment"],"description":"`add_shipment`: Record what you are sending to the supplier. Only on an order kept here."},"material":{"type":"object","description":"What is shipped: its kind, how it travels and between which countries","required":["kind","description","temperature","fromCountry","toCountry"],"properties":{"kind":{"type":"string","enum":["compound","protein","plasmid","cell_line","human_sample","animal_sample","animal_derived","other"]},"description":{"type":"string","minLength":3,"maxLength":500},"amount":{"type":"string","maxLength":100},"temperature":{"type":"string","enum":["ambient","chilled","dry_ice","ln2"]},"infectious":{"type":"boolean"},"gmo":{"type":"boolean"},"thirdParty":{"type":"boolean"},"hasCoa":{"type":"boolean"},"fromCountry":{"type":"string","minLength":2,"maxLength":2,"description":"Two-letter country code"},"toCountry":{"type":"string","minLength":2,"maxLength":2,"description":"Two-letter country code"},"dryIceKg":{"type":"number","minimum":0,"maximum":200},"finishedGoods":{"type":"boolean"}}},"samples":{"type":"array","maxItems":500,"description":"The samples in the shipment: your id for each, a description and an optional amount","items":{"type":"object","required":["id","description"],"properties":{"id":{"type":"string"},"description":{"type":"string"},"amount":{"type":"string"}}}},"bookedBy":{"type":"string","enum":["client","lab"],"default":"client","description":"Who books the courier: you or the supplier"}}},{"type":"object","title":"pay","description":"A card payment link for a payment that is due.","required":["action","paymentId"],"properties":{"action":{"type":"string","enum":["pay"],"description":"`pay`: A card payment link for a payment that is due."},"paymentId":{"type":"string","description":"A due payment's `id`, from the request's `payments`"}}},{"type":"object","title":"decide_change","description":"Approve or decline a change the supplier proposed.","required":["action","changeId","approve"],"properties":{"action":{"type":"string","enum":["decide_change"],"description":"`decide_change`: Approve or decline a change the supplier proposed."},"changeId":{"type":"string","description":"The change's `id`, from the request's `change_orders`"},"approve":{"type":"boolean","description":"true to approve, false to decline"}}},{"type":"object","title":"accept_results","description":"Accept what was delivered. Status `delivered` only.","required":["action"],"properties":{"action":{"type":"string","enum":["accept_results"],"description":"`accept_results`: Accept what was delivered. Status `delivered` only."}}},{"type":"object","title":"request_rerun","description":"Raise an issue with what was delivered. Status `delivered` only.","required":["action","reason"],"properties":{"action":{"type":"string","enum":["request_rerun"],"description":"`request_rerun`: Raise an issue with what was delivered. Status `delivered` only."},"reason":{"type":"string","minLength":5,"maxLength":1500,"description":"What is wrong, in the person's words; the supplier reads it"},"kind":{"type":"string","description":"The kind of problem, e.g. `quality` or `damage`. Defaults to the order's general kind."},"quantity":{"type":"string","maxLength":120,"description":"How much is affected, e.g. 6 of 20 pieces"},"photos":{"type":"array","maxItems":10,"items":{"type":"string"},"description":"Links to files uploaded to this order (/f/...)"}}},{"type":"object","title":"request_release","description":"Storage orders: give notice to leave. The release period agreed on the quote starts now.","required":["action"],"properties":{"action":{"type":"string","enum":["request_release"],"description":"`request_release`: Storage orders: give notice to leave. The release period agreed on the quote starts now."}}}],"discriminator":{"propertyName":"action"}},"examples":{"confirm":{"summary":"Ask two suppliers for quotes","value":{"action":"confirm_labs","slugs":["supplier-slug-one","supplier-slug-two"],"replyBy":"2026-12-04"}},"more":{"summary":"Ask one more supplier after a decline","value":{"action":"invite_more","supplierIds":["sup_..."]}},"spec":{"summary":"Fill in a needed field and mark another not known","value":{"action":"set_spec","spec":{"purity":">95%"},"specUnknown":["salt"]}},"keep":{"summary":"Accept a quote and keep the order here","value":{"action":"choose_managed","quoteId":"qt_...","termsName":"Ada Lovelace"}},"own":{"summary":"Take a quote to the supplier on your own","value":{"action":"choose_direct","quoteId":"qt_..."}},"issue":{"summary":"Raise an issue with what was delivered","value":{"action":"request_rerun","reason":"Six of twenty pieces arrived bent.","quantity":"6 of 20 pieces"}}}}}},"responses":{"200":{"description":"Done: `{ok: true}` plus, for `confirm_labs`, `chosen` (how many suppliers), `reachable` (how many of them have an email or a quote form, so the request can be sent), `not_reachable` (the names of the others) and `contacted` (the same as `reachable`, kept for existing clients); for `invite_more`, `invited`; for `choose_managed` and `pay`, `paymentUrl` (null when the order is invoiced); for `choose_direct`, `introducedTo` (the supplier's name; their contact details are on the request's timeline).","content":{"application/json":{"example":{"ok":true,"contacted":1,"chosen":1,"reachable":1,"not_reachable":[]}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: An unknown action, the action does not fit the request's status, a field is missing, or `set_spec` names a key the category does not have or a select value that is not one of its options. The message says which.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`not_found`: No request with that id for this key's email.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"409":{"description":"`conflict`: The request is cancelled: nothing more can be done on it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}},"500":{"description":"`server_error`: The action failed; check the request before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}}},"operationId":"actions","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#actions","description":"Docs. MCP tool: request_action"}}},"/api/v1/requests/{id}/cancel":{"post":{"summary":"Cancel a request before payment","description":"The suppliers asked are told the request is closed. `reason` stays internal; `outcome_reason` is what they are told.","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"req_..."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"Internal; never sent to suppliers"},"outcome_reason":{"type":"string","enum":["price","lead_time","capability","other"],"description":"Optional. The main reason the other suppliers were not chosen; they are told it, never who was chosen or at what price."}}}}}},"responses":{"200":{"description":"Cancelled","content":{"application/json":{"example":{"object":"request","id":"req_Xq3v9KpL2aB7","status":"cancelled"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: An unknown `outcome_reason`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`not_found`: No request with that id for this key's email.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"409":{"description":"`not_cancellable`: Already paid or under way.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"cancel","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#cancel","description":"Docs. MCP tool: cancel_request"}}},"/api/v1/uploads":{"post":{"summary":"Upload a file (CAD, sequences, sample sheet, artwork); put the returned url in a spec field","security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary","description":"multipart/form-data field `file`."}}}}}},"responses":{"201":{"description":"Stored","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["upload"]},"id":{"type":"string"},"filename":{"type":"string"},"size":{"type":"integer"},"url":{"type":"string"},"expires_at":{"type":"string","format":"date-time"}}},"example":{"object":"upload","id":"upl_Lm2nB7vC4xZ9","filename":"drawing.pdf","size":182044,"url":"https://midgardscience.aramous.com/f/…","expires_at":"2026-12-17T09:00:00.000Z"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: No `file` field. `invalid_file`: Empty, larger than 50 MB, or a type that is not accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"upload","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#upload","description":"Docs. MCP tool: upload_file"}}},"/api/v1/webhook":{"get":{"summary":"This key's webhook endpoint","security":[{"bearer":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"object":"webhook","url":null}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"webhookGet","tags":["Webhooks"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#webhook-get","description":"Docs"}},"put":{"summary":"Set the webhook endpoint; returns a new signing secret once","description":"Events for requests placed with this key: request.quoted, request.status_changed, request.message. Each POST carries `Webhook-Signature: t=<unix>,v1=<hex>` where v1 = HMAC-SHA256(secret, `${t}.${raw body}`).","security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":["string","null"],"format":"uri","description":"An https address on a public host. null stops deliveries."}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"object":"webhook","url":"https://example.com/hooks/orders","secret":"whsec_…"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: Not an https address on a public host.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"webhookPut","tags":["Webhooks"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#webhook-put","description":"Docs"}},"delete":{"summary":"Stop webhook deliveries","security":[{"bearer":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"object":"webhook","url":null}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}}},"operationId":"webhookDelete","tags":["Webhooks"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#webhook-delete","description":"Docs"}}},"/api/v1/quotes/{id}/accept":{"post":{"summary":"Accept a quote and say how you continue","description":"`continue: \"midgard\"` keeps the order here: send `terms_name`, the name of the person accepting the order terms (see /terms). A 1% platform fee is added as its own line. Without `po` the answer carries `payment_url` for the first card payment; with `po` each payment is invoiced. `continue: \"own\"` takes the quote to the supplier on your own, free: your contact details go to the supplier and theirs appear on the request's timeline. The same as the `choose_managed` and `choose_direct` actions.","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"qt_..., from GET /api/v1/requests/{id}."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["continue","terms_name"],"properties":{"continue":{"type":"string","enum":["midgard"],"description":"How the person continues."},"terms_name":{"type":"string","minLength":2,"maxLength":120,"description":"The name of the person accepting the order terms"},"po":{"type":"string","maxLength":80,"description":"Purchase order number. With one, payments are invoiced."},"billing_email":{"type":"string","format":"email","description":"Where invoices go, if not the key's email"},"revision":{"type":"string","maxLength":20,"description":"Parts: the file revision the order is built to, e.g. Rev C"},"outcome_reason":{"type":"string","enum":["price","lead_time","capability","other"],"description":"Optional. The main reason the other suppliers were not chosen; they are told it, never who was chosen or at what price."}}},{"type":"object","required":["continue"],"properties":{"continue":{"type":"string","enum":["own"],"description":"How the person continues."},"outcome_reason":{"type":"string","enum":["price","lead_time","capability","other"],"description":"Optional. The main reason the other suppliers were not chosen; they are told it, never who was chosen or at what price."}}}]},"examples":{"keep":{"summary":"Keep the order here","value":{"continue":"midgard","terms_name":"Ada Lovelace"}},"own":{"summary":"Continue on your own","value":{"continue":"own"}}}}}},"responses":{"200":{"description":"The quote, with `continue` as sent. `midgard`: status `accepted` and `payment_url`. `own`: `supplier`, the supplier's name.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Quote"},{"type":"object","properties":{"continue":{"type":"string","enum":["midgard","own"]},"supplier":{"type":["string","null"]}}}]},"example":{"id":"qt_Hn4sD8wQ1zR6","object":"quote","price":4800,"currency":"USD","turnaround_days":15,"valid_until":"2026-12-17T00:00:00.000Z","terms":null,"status":"sent","payment_url":null,"paid":false,"continue":"own","supplier":"Example Lab"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"400":{"description":"`invalid_request`: No `continue`, no `terms_name` for \"midgard\", an unknown `outcome_reason`, or the quote can no longer be accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"401":{"description":"`unauthorized`: No key, or a key that is wrong or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`not_found`: No quote with that id on this email's requests.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}},"429":{"description":"`rate_limited`: More than 120 calls a minute with this key. The answer carries `Retry-After`, the seconds to wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before trying again","schema":{"type":"integer"}}}},"500":{"description":"`server_error`: The quote could not be accepted; check the request before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"RateLimit-Limit":{"description":"Calls the window allows","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Calls left in the window","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until a call is freed","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"The limit and its window in seconds, e.g. `120;w=60`","schema":{"type":"string"}}}}},"operationId":"acceptQuote","tags":["Requests"],"externalDocs":{"url":"https://midgardscience.aramous.com/developers/api#accept-quote","description":"Docs. MCP tool: accept_quote"}}}},"tags":[{"name":"Directory","description":"Search and read listings. No key needed."},{"name":"Keys","description":"Sign in by a code sent by email and manage keys."},{"name":"Requests","description":"Requests for quotes, quotes, orders, messages and files."},{"name":"Webhooks","description":"Callbacks when a request changes."}],"externalDocs":{"url":"https://midgardscience.aramous.com/developers","description":"Developer docs, quick starts and MCP setup"}}