{ "openapi": "3.0.1", "info": { "title": "Fincen Msb Scraper", "description": "The full FinCEN registry of registered Money Services Businesses: every US and foreign money transmitter, check casher, currency dealer and prepaid access business, with address, decoded activity types, states of operation and registration date. Filter for AML and KYB compliance, or look up by name.", "version": "1.0", "x-build-id": "CqiBTEVsom7zTBBVs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~fincen-msb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-fincen-msb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/normdata~fincen-msb-scraper/runs": { "post": { "operationId": "runs-sync-normdata-fincen-msb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/normdata~fincen-msb-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-fincen-msb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Caps how many rows this run writes. Starts at 10 for a quick sample; raise it for a full run (the whole registry is about 33,000 businesses)." }, "mode": { "title": "What to do", "enum": [ "search", "lookup" ], "type": "string", "description": "Search filters the FinCEN MSB registrant list into a list. Look up resolves legal names or trade names, one row per identifier.", "default": "search" }, "name": { "title": "Name contains (for Search)", "type": "string", "description": "Match businesses whose legal name or registered trade name (DBA) contains this text." }, "state": { "title": "State(s) (for Search)", "type": "array", "description": "Two-letter state code of the business address, e.g. CA, NY, TX. Leave empty for all states.", "items": { "type": "string" } }, "city": { "title": "City contains (for Search)", "type": "string", "description": "Match businesses whose city contains this text." }, "zip": { "title": "ZIP starts with (for Search)", "type": "string", "description": "Match businesses whose ZIP code starts with this, e.g. 900 for Los Angeles area." }, "activity": { "title": "MSB activity (for Search)", "uniqueItems": true, "type": "array", "description": "Keep only businesses registered for one or more of these activity types. Combine freely.", "items": { "type": "string", "enum": [ "money_transmitter", "check_casher", "currency_dealer", "money_orders", "travelers_checks", "prepaid_access", "foreign_exchange", "us_postal", "other" ], "enumTitles": [ "Money transmitter", "Check casher", "Currency dealer or exchanger", "Money order business", "Traveler's check business", "Prepaid access (seller or provider)", "Dealer in foreign exchange", "U.S. Postal Service", "Other" ] } }, "moneyTransmittersOnly": { "title": "Money transmitters only (for Search)", "type": "boolean", "description": "Shortcut for activity money_transmitter (Form 107 code 409), the largest segment and the one most relevant to fintech and crypto due diligence.", "default": false }, "activityCode": { "title": "Raw Form 107 code(s) (for Search)", "type": "array", "description": "Advanced: exact FinCEN Form 107 activity codes, e.g. 409, 408, 415. Combined with the activity field above.", "items": { "type": "string" } }, "operatesInState": { "title": "Registered to operate in state(s) (for Search)", "type": "array", "description": "Two-letter state code(s). Keep only businesses whose registered states of MSB activity include this state (or that are registered for all states).", "items": { "type": "string" } }, "foreignOnly": { "title": "Foreign-based businesses only (for Search)", "type": "boolean", "description": "Only MSBs located outside the United States.", "default": false }, "usOnly": { "title": "US-based businesses only (for Search)", "type": "boolean", "description": "Only MSBs located in the United States.", "default": false }, "foreignCountry": { "title": "Foreign location contains (for Search)", "type": "string", "description": "Match foreign-based MSBs whose location contains this text, e.g. \"HONG KONG\", \"CANADA\", \"UNITED KINGDOM\"." }, "minBranches": { "title": "Min branch count (for Search)", "minimum": 0, "type": "integer", "description": "Only businesses with at least this many branches." }, "maxBranches": { "title": "Max branch count (for Search)", "minimum": 0, "type": "integer", "description": "Only businesses with at most this many branches, e.g. 0 for single-location operators." }, "registeredAfter": { "title": "Registered on or after (for Search)", "type": "string", "description": "ISO date (2026-01-01). Only businesses whose FinCEN registration (received) date is on or after this, a new-registrant filter." }, "registeredBefore": { "title": "Registered on or before (for Search)", "type": "string", "description": "ISO date. Only businesses registered on or before this." }, "registeredInLastDays": { "title": "Registered within the last N days (for Search)", "type": "integer", "description": "Only businesses whose registration date is within this many days, for a recent-registrations watch list." }, "identifiers": { "title": "Legal or trade names (for Look up)", "type": "array", "description": "Legal names or DBA names. Each matches the first business whose legal or trade name contains the text; unmatched names come back as an error row.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }