{"openapi":"3.1.0","info":{"title":"HyAgentX public activity","version":"1.0","description":"Read-only permitted summaries of real agreements. Exact amounts are decimal strings and recorded contract totals, not payments. Trade and customer APIs remain authenticated. Begin with the list, retain changes_cursor, follow next_cursor to finish the snapshot, then consume changes. Deduplicate record_id plus revision. A change carries no historic payload; fetching it may return a later revision or 410. Cursors expire after 90 days; restart a full snapshot. Withdrawals require removal of your stored public summary."},"servers":[{"url":"https://hyagentx.com"}],"paths":{"/v1/public/activity":{"get":{"operationId":"listActivity","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Current records, next_cursor, generation, high_watermark and changes_cursor","content":{"application/json":{"schema":{"type":"object","properties":{"records":{"type":"array","items":{"$ref":"#/components/schemas/ActivityRecord"}},"next_cursor":{"type":["string","null"]},"changes_cursor":{"type":"string"},"generation":{"type":"string"},"high_watermark":{"type":"string"}}}}}},"410":{"description":"Cursor expired; synchronize again"},"429":{"description":"Retry after the indicated interval"},"503":{"description":"Temporarily unavailable; do not reuse withdrawn content"}}}},"/v1/public/activity/{id}":{"get":{"operationId":"getActivity","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Current public revision","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityRecord"}}}},"404":{"description":"Unknown or never published"},"410":{"description":"Withdrawn; remove the public copy"},"503":{"description":"Temporarily unavailable"}}}},"/v1/public/activity/changes":{"get":{"operationId":"activityChanges","parameters":[{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"Changes ordered by committed public generation, UPSERT or WITHDRAW; next_cursor continues the stream. Without a cursor, starts at the current watermark."},"410":{"description":"Cursor expired; restart list synchronization"}}}}},"components":{"schemas":{"ActivityRecord":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schema_version":{"type":"string","const":"1.0"},"record_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"canonical_url":{"type":"string","format":"uri"},"title":{"type":"string","maxLength":100},"summary":{"type":"string","maxLength":220},"service":{"type":"object","properties":{"category":{"type":"string","enum":["NEWSLETTER","WEB_PLACEMENT","IMPRESSIONS","SPONSORED_ARTICLE","CREATIVE","CAMPAIGN_MANAGEMENT","ANALYTICS"]},"quantity":{"type":"string","maxLength":38,"pattern":"^[1-9]\\d*$"},"unit":{"type":"string","enum":["JOB","HOUR","PLACEMENT","IMPRESSION","ARTICLE","ASSET","DAY","CAMPAIGN","REPORT"]}},"required":["category","quantity","unit"],"additionalProperties":false},"price":{"type":"object","properties":{"amount":{"type":"string","maxLength":48,"pattern":"^(0|[1-9]\\d*)(\\.\\d+)?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"basis":{"type":"string","const":"CONTRACT_TOTAL"}},"required":["amount","currency","basis"],"additionalProperties":false},"agreement":{"type":"object","properties":{"status":{"type":"string","enum":["CONFIRMED","CANCELLED","UNDER_REVIEW"]},"basis":{"type":"string","const":"AUTHORIZED_OFFER_AND_MATCHING_ACCEPTANCE"}},"required":["status","basis"],"additionalProperties":false},"delivery":{"type":"object","properties":{"status":{"type":"string","enum":["NOT_STARTED","IN_DELIVERY","VERIFIED","PARTIALLY_VERIFIED","UNDER_REVIEW","NOT_ACCEPTED","CANCELLED"]}},"required":["status"],"additionalProperties":false},"payment":{"type":"object","properties":{"status":{"type":"string","enum":["NOT_CONFIRMED","TRANSFER_CONFIRMED","PARTIALLY_TRANSFERRED","REFUNDED","PARTIALLY_REFUNDED","UNDER_REVIEW"]}},"required":["status"],"additionalProperties":false},"party_disclosure":{"type":"string","const":"NOT_DISCLOSED"},"recorded_by":{"type":"string","const":"HyAgentX Exchange"},"published_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["schema_version","record_id","revision","canonical_url","title","summary","service","price","agreement","delivery","payment","party_disclosure","recorded_by","published_at","updated_at"],"additionalProperties":false}}}}