{"uid":"cap__bSFx_uJEFUo9phKgee8V","slug":"2s-io-29e2853e","name":"Congress.gov Treaty Lookup","description":"Look up or list international treaties transmitted to the US Senate for advice and consent via Congress.gov. Pass congress + number (optionally + suffix for partitioned treaties) to fetch a single treaty with parties, topic, transmittal date, and consideration status. Or list by congress. Returns the congress the treaty was received in, the congress that considered it (if any), partial-treaty suffix, topic, transmitted date, and count of parties.","url":"https://2s.io/api/gov/congress-treaty","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"limit":{"type":"integer","default":25,"maximum":250,"minimum":1},"number":{"type":"integer"},"offset":{"type":"integer","default":0,"minimum":0},"suffix":{"type":"string","description":"Partition letter (e.g. \"A\")."},"congress":{"type":"integer"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":10,"offset":0,"congress":118}}},"response":{"data":{"ok":true,"meta":{"mode":"list"},"items":[{"topic":"International Law and Organization","number":2,"suffix":"","updateDate":"2024-12-19T00:18:14Z","transmittedDate":"2024-12-18T00:00:00Z","congressReceived":118,"congressConsidered":null,"countriesPartiesCount":null},{"topic":"Maritime Boundaries and Claims","number":1,"suffix":"","updateDate":"2023-12-19T04:01:18Z","transmittedDate":"2023-12-18T00:00:00Z","congressReceived":118,"congressConsidered":null,"countriesPartiesCount":null}],"total":2,"source":{"url":"https://api.congress.gov/","license":"Public domain (US government work)","provider":"Congress.gov API (Library of Congress)"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"gov.congress-treaty","settlement":{"txHash":"0xd556971dfabe2ac13e87f2c9f62fe5a5e795fbe8727c7ce28d9a2d840319145b","network":"eip155:8453","success":true}}}},"exampleRequest":{"limit":10,"offset":0,"congress":118},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DkML5-0T3lZfxOhFLFL2_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up or list international treaties transmitted to the US Senate for advice and consent, including parties, topic, transmittal date, and consideration status.","exampleAgentPrompt":"Can you pull up the details for treaty number 3 from the 118th Congress, including which parties signed it, what topic it covers, and when it was transmitted to the Senate?","exampleUseCases":null,"resultDescription":"Returns structured treaty data including: the congress that received the treaty, the congress that considered it (if any), the partial-treaty suffix (if applicable), the treaty topic, the transmittal date, a list of parties, and the count of parties. When listing, returns paginated results across all treaties for a given congress.","failureModes":["Treaty not found for given congress + number combination returns 404","Missing required congress parameter may return validation error","Invalid suffix format returns error","Rate limiting or payment failure returns 402","Offset or limit out of bounds returns validation error"],"whenToPreferThis":"Use this endpoint when you need structured, authoritative data on international treaties submitted to the US Senate — particularly when you need to filter by congress number, look up a specific treaty by number and optional suffix, or enumerate all treaties received by a particular congress. Prefer this over general web search when you need machine-readable treaty metadata including parties, topic, and transmittal dates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:35.761Z","isFirstParty":false}