{"uid":"cap_w3kMGo2VWc4637Wy5qCdn","slug":"hermes-counterparty-availability-api-3a0fd3ac","name":"Hermes Counterparty Availability API","description":"Agent utilities for company research, package maintenance intelligence, dependency vulnerability checks, counterparty availability, SEC company snapshots, OFAC sanctions screening, and deterministic JSON/CSV data-quality work. Company domain intelligence includes a free preview before the paid enrichment call.","url":"https://hermes-counterparty-api.onrender.com/v1/counterparty-availability","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"timezone":{"type":"string","description":"Optional IANA timezone; defaults to the country's primary business timezone"},"country_code":{"enum":["US","CA","MX","GB","DE","FR","ES","IT","BR","JP","IN","AU"],"type":"string","description":"ISO 3166-1 alpha-2 country code"}}},"responseSchema":{"type":"json","example":{"local":{"iso":"2026-08-20T08:00","date":"2026-08-20","time":"08:00","weekday":"Thu"},"country":{"code":"US","name":"United States","currency":"USD","calling_code":"+1","holiday_scope":"US federal"},"business":{"is_weekend":false,"holiday_name":null,"contact_window":"closed","is_business_day":true,"is_public_holiday":false,"next_business_date":"2026-08-20","next_contact_local":"2026-08-20T09:00","assumed_business_hours":"09:00-17:00 local","business_days_remaining_this_week":2},"timezone":"America/Chicago","timezone_source":"request"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LERaJDw7trcFRkIbm-Bde","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns business-day and contact-window status for a given country, indicating whether counterparties are reachable right now based on local time, public holidays, and business hours.","exampleAgentPrompt":"Is today a business day in Germany, and if not, when's the next time I can reach someone there during business hours? Use the Europe/Berlin timezone.","exampleUseCases":[{"title":"Pre-call availability check for global supplier","prompt":"Before I send this urgent purchase order to our supplier in Japan, can you check if it's currently within their business hours or tell me when the next contact window opens?"},{"title":"Automated payment scheduling across borders","prompt":"I need to wire funds to a vendor in Brazil — is today a business day there, and if not, what's the next business date so I can schedule the transfer correctly?"},{"title":"Holiday-aware workflow routing for UK office","prompt":"Check if the UK office is reachable today — I want to know if it's a public holiday or weekend before I route these support tickets to them."}],"resultDescription":"A JSON object containing: local datetime details (ISO timestamp, date, time, weekday), country metadata (name, currency, calling code, holiday scope), and a business context block covering whether today is a business day, whether it is a weekend or public holiday, the name of any holiday, the current contact window status, the next business date, the next contactable local datetime, assumed business hours, and business days remaining in the current week. Also includes the resolved timezone and its source.","failureModes":["Unsupported country code — only 12 country codes accepted; passing an unlisted ISO code will likely return a validation error","Invalid IANA timezone string — malformed or unrecognized timezone values may cause a 400 error or fallback to country default","Payment failure — missing or insufficient x402 USDC payment header will result in a 402 Payment Required response","Service unavailability — hosted on Render free tier, cold starts or downtime may cause timeouts or 503 errors","Stale holiday data — public holiday schedules may not be updated for newly announced or regional holidays"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, structured answer about whether a business counterparty in a specific country is reachable right now — accounting for weekends, public holidays, and local business hours. It is especially useful for agents automating cross-border scheduling, payment timing, or communication routing where getting the business-day status wrong has real consequences. Prefer it over generic timezone converters when you need the full business-context picture (holiday name, contact window, next business date) in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:04.369Z","isFirstParty":false}