{"uid":"cap_glDsnPJ2zVbPL1VlwyHXw","slug":"foresight-api-flows-lookup-13f68453","name":"Foresight API – Flows Lookup","description":"Foresight API request","url":"https://api.creativeforesight.io/v1/flows","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["origin","destination","measure"],"properties":{"origin":{"type":"string"},"measure":{"type":"string"},"destination":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":{"type":"json","example":{"data":[{"value":12500,"origin":"47187","destination":"US"}],"meta":{"total":1}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nVU21jKP-eX1GG-YcihgI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns flow measurement data between an origin and destination, such as migration, trade, or movement volumes.","exampleAgentPrompt":"Pull the flow data from origin 47187 to the US using the Foresight API — I want to see the volume measurement between those two points.","exampleUseCases":[{"title":"Migration flow between zip code and country","prompt":"Show me the migration flow from zip code 47187 to the United States — what's the total volume?"},{"title":"Trade flow analysis between regions","prompt":"Get me the trade flow measurement from origin region 47187 to destination US so I can compare it against last quarter's figures."},{"title":"Population movement monitoring","prompt":"I want to check the current movement flows out of 47187 heading into the US — pull the latest Foresight flow data for that corridor."}],"resultDescription":"Returns a JSON object with a data array containing flow records, each with a numeric value, an origin identifier, and a destination identifier, along with a meta object indicating the total number of records returned.","failureModes":["Missing required query parameters (origin, destination, or measure) returns a 400 or validation error","Invalid or unrecognized origin/destination identifiers may return empty data arrays","Missing or invalid bearer API key returns 401 unauthorized","Insufficient x402 payment causes a 402 Payment Required response","Rate limiting or quota exhaustion may result in 429 errors","No data available for the given origin-destination pair returns an empty data array with total 0"],"whenToPreferThis":"Use this endpoint when you need directional flow measurements (e.g. migration, trade, movement) between a specific origin and destination from the Foresight platform. It is ideal when you have structured origin and destination identifiers and a defined measure type, and need a numeric volume value for that corridor. Prefer this over general geospatial APIs when working within the Foresight ecosystem or when x402 micropayment-compatible workflows are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:59.351Z","isFirstParty":false}