{"info":{"name":"ParseAPI · Start here","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json","description":"Five ready-to-send requests. Start with User-Agent without a key. Import the ParseAPI environment, select it, and set api_key to your secret key as a local value for the remaining requests. Keep the shared value empty.\n\nGuide: https://parseapi.com/integrate/postman\nEnvironment: https://parseapi.com/postman/parseapi.postman_environment.json\nFull API catalog: https://parseapi.com/openapi.json\n\nRequests pin Parse-Version: 2.0.0. The four authenticated starter requests use your monthly request allowance. Optional parameters start unchecked. Email deep is separately metered. Saved examples are illustrative and may shorten lists. They make no requests. Tests check HTTP success, JSON and the selected API version, not whether every field is known or valid is true."},"auth":{"type":"apikey","apikey":[{"key":"key","value":"X-API-Key","type":"string"},{"key":"value","value":"{{api_key}}","type":"string"},{"key":"in","value":"header","type":"string"}]},"variable":[{"key":"base_url","value":"https://api.parseapi.com","type":"string"},{"key":"api_key","value":"","type":"string"}],"event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Request succeeded\", function () { pm.response.to.have.status(200); });","pm.test(\"Response is a JSON object\", function () { pm.expect(pm.response.json()).to.be.an(\"object\"); });","pm.test(\"API 2.0.0 answered\", function () { pm.expect(pm.response.headers.get(\"Parse-Version\")).to.eql(\"2.0.0\"); });"]}}],"item":[{"name":"Start here","description":"Send the first request without a key. Add your key once for the next four.","item":[{"name":"01 · Parse a User-Agent","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"},{"key":"User-Agent","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"}],"url":{"raw":"{{base_url}}/useragent","host":["{{base_url}}"],"path":["useragent"],"query":[]},"description":"Send this first. No API key needed. The sample User-Agent header makes the example reproducible.\n\nBare (no ua parameter) it parses the User-Agent that made the request, no key needed. With ?ua= it is a keyed lookup. Full field reference: https://parseapi.com/docs/useragent\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked.","auth":{"type":"noauth"}},"response":[{"name":"Core example","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"},{"key":"User-Agent","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"}],"url":{"raw":"{{base_url}}/useragent","host":["{{base_url}}"],"path":["useragent"],"query":[]},"description":"Send this first. No API key needed. The sample User-Agent header makes the example reproducible.\n\nBare (no ua parameter) it parses the User-Agent that made the request, no key needed. With ?ua= it is a keyed lookup. Full field reference: https://parseapi.com/docs/useragent\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked.","auth":{"type":"noauth"}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"cookie":[],"body":"{\n  \"useragent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\",\n  \"device\": \"desktop\",\n  \"os\": \"macOS\",\n  \"browser\": \"Chrome\",\n  \"bot\": false,\n  \"mobile\": false\n}"}]},{"name":"02 · Look up a country","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/country/ca","host":["{{base_url}}"],"path":["country","ca"],"query":[{"key":"lang","value":"fr","description":"Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.","disabled":true},{"key":"deep","value":"true","description":"Country profiles, physical geography, statistics, regional conventions, tax references and alternate identifiers. Included on paid plans.","disabled":true}]},"description":"Add your secret API key to the selected environment, then send. This uses your monthly request allowance.\n\nCountry names, currency, languages, and timezones. Full field reference: https://parseapi.com/docs/country\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"response":[{"name":"Core example (lists shortened)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/country/ca","host":["{{base_url}}"],"path":["country","ca"],"query":[{"key":"lang","value":"fr","description":"Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.","disabled":true},{"key":"deep","value":"true","description":"Country profiles, physical geography, statistics, regional conventions, tax references and alternate identifiers. Included on paid plans.","disabled":true}]},"description":"Add your secret API key to the selected environment, then send. This uses your monthly request allowance.\n\nCountry names, currency, languages, and timezones. Full field reference: https://parseapi.com/docs/country\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"cookie":[],"body":"{\n  \"country\": \"CA\",\n  \"name\": \"Canada\",\n  \"continent\": \"NA\",\n  \"currency\": \"CAD\",\n  \"currency_name\": \"Canadian Dollar\",\n  \"currency_symbol\": \"C$\",\n  \"calling_code\": \"+1\",\n  \"emoji\": \"🇨🇦\",\n  \"languages\": [\n    \"en\"\n  ],\n  \"timezones\": [\n    \"America/Cambridge_Bay\",\n    \"America/Dawson\",\n    \"America/Dawson_Creek\",\n    \"America/Edmonton\"\n  ]\n}"},{"name":"Missing key example","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/country/ca","host":["{{base_url}}"],"path":["country","ca"],"query":[{"key":"lang","value":"fr","description":"Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.","disabled":true},{"key":"deep","value":"true","description":"Country profiles, physical geography, statistics, regional conventions, tax references and alternate identifiers. Included on paid plans.","disabled":true}]},"description":"Add your secret API key to the selected environment, then send. This uses your monthly request allowance.\n\nCountry names, currency, languages, and timezones. Full field reference: https://parseapi.com/docs/country\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked.","auth":{"type":"noauth"}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"cookie":[],"body":"{\n  \"code\": \"invalid_api_key\",\n  \"message\": \"An API key is required.\",\n  \"docs\": \"https://parseapi.com/docs#invalid_api_key\",\n  \"request_id\": \"req_example\"\n}"}]},{"name":"03 · Check an email format and domain","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/email/hello@gmail.com","host":["{{base_url}}"],"path":["email","hello@gmail.com"],"query":[{"key":"deep","value":"true","description":"When true, include optional detail in deep. Access depends on the endpoint: pooled detail, an included paid-plan profile, or a metered check. Core values stay unchanged.","disabled":true}]},"description":"Core checks use your monthly request allowance. The deep parameter is off. Enabling Email deep runs a separately metered mailbox check.\n\nCheck syntax, consumer mailbox, disposable and role addresses, reserved domain type, typo suggestions, and the domain mail route. deep=true adds mailbox deliverability, catchall, a status and reason, a suggested first name, no-reply flag, plus tag, and recognized mail provider. Suggested names are not verified identity. Older checks may have null detail. Results may reuse an earlier mailbox check. A mailbox check that does not complete returns null mailbox verdict fields and is not billed. Local address details may still be available. Full field reference: https://parseapi.com/docs/email\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"response":[{"name":"Core example","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/email/hello@gmail.com","host":["{{base_url}}"],"path":["email","hello@gmail.com"],"query":[{"key":"deep","value":"true","description":"When true, include optional detail in deep. Access depends on the endpoint: pooled detail, an included paid-plan profile, or a metered check. Core values stay unchanged.","disabled":true}]},"description":"Core checks use your monthly request allowance. The deep parameter is off. Enabling Email deep runs a separately metered mailbox check.\n\nCheck syntax, consumer mailbox, disposable and role addresses, reserved domain type, typo suggestions, and the domain mail route. deep=true adds mailbox deliverability, catchall, a status and reason, a suggested first name, no-reply flag, plus tag, and recognized mail provider. Suggested names are not verified identity. Older checks may have null detail. Results may reuse an earlier mailbox check. A mailbox check that does not complete returns null mailbox verdict fields and is not billed. Local address details may still be available. Full field reference: https://parseapi.com/docs/email\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"cookie":[],"body":"{\n  \"email\": \"hello@gmail.com\",\n  \"didyoumean\": null,\n  \"valid\": true,\n  \"free\": true,\n  \"disposable\": false,\n  \"role\": true,\n  \"domain\": \"gmail.com\",\n  \"domain_type\": null,\n  \"domain_valid\": true\n}"},{"name":"Malformed email example","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/email/not-an-email","host":["{{base_url}}"],"path":["email","not-an-email"],"query":[{"key":"deep","value":"true","description":"When true, include optional detail in deep. Access depends on the endpoint: pooled detail, an included paid-plan profile, or a metered check. Core values stay unchanged.","disabled":true}]},"description":"Core checks use your monthly request allowance. The deep parameter is off. Enabling Email deep runs a separately metered mailbox check.\n\nCheck syntax, consumer mailbox, disposable and role addresses, reserved domain type, typo suggestions, and the domain mail route. deep=true adds mailbox deliverability, catchall, a status and reason, a suggested first name, no-reply flag, plus tag, and recognized mail provider. Suggested names are not verified identity. Older checks may have null detail. Results may reuse an earlier mailbox check. A mailbox check that does not complete returns null mailbox verdict fields and is not billed. Local address details may still be available. Full field reference: https://parseapi.com/docs/email\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"cookie":[],"body":"{\n  \"code\": \"invalid_request\",\n  \"message\": \"Invalid email address.\",\n  \"docs\": \"https://parseapi.com/docs#invalid_request\",\n  \"request_id\": \"req_example\"\n}"}]},{"name":"04 · Look up a postal code","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/postal/10001?country=US","host":["{{base_url}}"],"path":["postal","10001"],"query":[{"key":"country","value":"US"},{"key":"lang","value":"fr","description":"Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.","disabled":true},{"key":"deep","value":"true","description":"Population, area, elevation, tax references, nearby postal codes and metropolitan areas. Included on paid plans.","disabled":true}]},"description":"Keep country=US with this example. Postal codes need country context. This uses your monthly request allowance.\n\ncity, state_name, and district_name are English or an official romanization when a trusted source has them, native otherwise. city_local, state_name_local, and district_name_local carry the native form when it differs. Null when absent or the same as the primary field. Unique codes resolve without ?country=. A collision 404s asking for it. Never defaults to US. Paid deep adds a combined US ZIP sales tax reference in deep.tax, deep.tax_rate, and the deep.tax_rate_state, deep.tax_rate_county, deep.tax_rate_city and deep.tax_rate_special components. Rates are percentages: 7.9 means 7.9%. Components are already included in the total. 0 is known zero; null is unavailable. An exact address can have a different rate. Do not add country, state and ZIP references together. Australian suburb/locality choices from the August 2026 G-NAF edition. Each option carries its own state. Null outside the reviewed reference; [] means a reviewed postcode has no eligible choices. One option does not establish an unambiguous city: use city for autofill and localities for explicit selection. Geographic reference, not mailing-address verification. US ZIP metropolitan and micropolitan area associations. Null when unsupported or unverified; [] only when complete observations place the ZIP outside every CBSA. Sorted by descending share (null last), then code. Shares are address fractions and are not renormalized. Full field reference: https://parseapi.com/docs/postal\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"response":[{"name":"Core example","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/postal/10001?country=US","host":["{{base_url}}"],"path":["postal","10001"],"query":[{"key":"country","value":"US"},{"key":"lang","value":"fr","description":"Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.","disabled":true},{"key":"deep","value":"true","description":"Population, area, elevation, tax references, nearby postal codes and metropolitan areas. Included on paid plans.","disabled":true}]},"description":"Keep country=US with this example. Postal codes need country context. This uses your monthly request allowance.\n\ncity, state_name, and district_name are English or an official romanization when a trusted source has them, native otherwise. city_local, state_name_local, and district_name_local carry the native form when it differs. Null when absent or the same as the primary field. Unique codes resolve without ?country=. A collision 404s asking for it. Never defaults to US. Paid deep adds a combined US ZIP sales tax reference in deep.tax, deep.tax_rate, and the deep.tax_rate_state, deep.tax_rate_county, deep.tax_rate_city and deep.tax_rate_special components. Rates are percentages: 7.9 means 7.9%. Components are already included in the total. 0 is known zero; null is unavailable. An exact address can have a different rate. Do not add country, state and ZIP references together. Australian suburb/locality choices from the August 2026 G-NAF edition. Each option carries its own state. Null outside the reviewed reference; [] means a reviewed postcode has no eligible choices. One option does not establish an unambiguous city: use city for autofill and localities for explicit selection. Geographic reference, not mailing-address verification. US ZIP metropolitan and micropolitan area associations. Null when unsupported or unverified; [] only when complete observations place the ZIP outside every CBSA. Sorted by descending share (null last), then code. Shares are address fractions and are not renormalized. Full field reference: https://parseapi.com/docs/postal\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"cookie":[],"body":"{\n  \"postal\": \"10001\",\n  \"city\": \"New York\",\n  \"district\": \"36061\",\n  \"district_name\": \"New York\",\n  \"state\": \"NY\",\n  \"state_name\": \"New York\",\n  \"country\": \"US\",\n  \"country_name\": \"United States\",\n  \"latitude\": 40.750649,\n  \"longitude\": -73.997298,\n  \"timezone\": \"America/New_York\"\n}"}]},{"name":"05 · Identify a card brand","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/card/51","host":["{{base_url}}"],"path":["card","51"],"query":[{"key":"deep","value":"true","description":"Recorded issuer details and the actual matched prefix. Partial coverage; unknown fields stay null. Included on every plan, with no additional charge.","disabled":true}]},"description":"Send only 2-11 leading digits, never a full card number. This uses your monthly request allowance. Card deep is included on every plan. A prefix shorter than six digits returns null issuer fields.\n\nSend 2–11 leading digits as a string. Core returns brand, brand_name and a CDN SVG logo independently of issuer coverage. Unknown or ambiguous brands use null fields and a generic logo. Optional deep=true adds recorded issuer details; six or more digits enable directory matching. The longest recorded prefix wins including its null fields, with no parent backfill. Coverage is partial and does not prove card validity or payment acceptance. One pooled request on every plan, including Deep. Never send a full card number. Full field reference: https://parseapi.com/docs/card\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"response":[{"name":"Core example","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/card/51","host":["{{base_url}}"],"path":["card","51"],"query":[{"key":"deep","value":"true","description":"Recorded issuer details and the actual matched prefix. Partial coverage; unknown fields stay null. Included on every plan, with no additional charge.","disabled":true}]},"description":"Send only 2-11 leading digits, never a full card number. This uses your monthly request allowance. Card deep is included on every plan. A prefix shorter than six digits returns null issuer fields.\n\nSend 2–11 leading digits as a string. Core returns brand, brand_name and a CDN SVG logo independently of issuer coverage. Unknown or ambiguous brands use null fields and a generic logo. Optional deep=true adds recorded issuer details; six or more digits enable directory matching. The longest recorded prefix wins including its null fields, with no parent backfill. Coverage is partial and does not prove card validity or payment acceptance. One pooled request on every plan, including Deep. Never send a full card number. Full field reference: https://parseapi.com/docs/card\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"cookie":[],"body":"{\n  \"bin\": \"51\",\n  \"brand\": \"mastercard\",\n  \"brand_name\": \"Mastercard\",\n  \"logo\": \"https://cdn.parseapi.com/card/mastercard.svg\"\n}"},{"name":"Deep with unknown issuer example","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"url":{"raw":"{{base_url}}/card/51?deep=true","host":["{{base_url}}"],"path":["card","51"],"query":[{"key":"deep","value":"true"}]},"description":"Send only 2-11 leading digits, never a full card number. This uses your monthly request allowance. Card deep is included on every plan. A prefix shorter than six digits returns null issuer fields.\n\nSend 2–11 leading digits as a string. Core returns brand, brand_name and a CDN SVG logo independently of issuer coverage. Unknown or ambiguous brands use null fields and a generic logo. Optional deep=true adds recorded issuer details; six or more digits enable directory matching. The longest recorded prefix wins including its null fields, with no parent backfill. Coverage is partial and does not prove card validity or payment acceptance. One pooled request on every plan, including Deep. Never send a full card number. Full field reference: https://parseapi.com/docs/card\n\nSaved responses are illustrative examples. Current data can differ. Optional parameters start unchecked."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Parse-Version","value":"2.0.0"}],"cookie":[],"body":"{\n  \"bin\": \"51\",\n  \"brand\": \"mastercard\",\n  \"brand_name\": \"Mastercard\",\n  \"logo\": \"https://cdn.parseapi.com/card/mastercard.svg\",\n  \"deep\": {\n    \"prefix\": null,\n    \"issuer\": null,\n    \"country\": null,\n    \"type\": null,\n    \"prepaid\": null\n  }\n}"}]}]}]}