Precisely APIs Byboundary API
The Byboundary API from Precisely APIs — 2 operation(s) for byboundary.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/precisely-apis-byboundary-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
contact:
name: Precisely APIs Support
url: https://support.precisely.com
description: '
Demographics. Audience Enrichment. Add local demographics and lifestyle
segmentation to your audience profiles. The Demographics API returns
household demographics and lifestyle characteristics with the input of an
address, location coordinate, or geographic boundary. This service covers
select countries.'
license:
name: Apache 2.0
url: http://springdoc.org
termsOfService: http://swagger.io/terms/
title: Precisely Byboundary API
version: 18.1.0
servers:
- url: https://api.precisely.com
security:
- oAuth2Password:
- ''
tags:
- name: Byboundary
paths:
/addresses/v1/addresscount/byboundary:
post:
description: This service accepts custom geographic boundaries or drive time & drive distance, returns the total number of addresses within these boundaries.
operationId: getAddressesCountbyBoundary
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AddressesByBoundaryRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/addressesCount'
application/xml:
schema:
$ref: '#/components/schemas/addressesCount'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorInfo'
description: Bad Request
'500':
content:
application/json:
schema:
type: string
application/xml:
schema:
type: string
description: Internal Server Error
security:
- oAuth2Password: []
summary: Addresses count by Boundary.
tags:
- Byboundary
x-contentType: application/json
x-accepts: application/json
/places/v1/poi/byboundary:
post:
description: Accepts a user-defined boundary as input and returns all Points of Interest within the boundary. Additionally, user can filter the response by name, type, standard industrial classifications and category codes.
operationId: getPOIsByGeometry
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/POIByGeometryRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PlacesResponse'
text/csv:
schema:
$ref: '#/components/schemas/PlacesResponse'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorInfo_1'
text/csv:
schema:
$ref: '#/components/schemas/ErrorInfo_1'
description: Bad Request
'500':
content:
application/json:
schema:
type: string
text/csv:
schema:
type: string
description: Internal Server Error
security:
- oAuth2Password: []
summary: Points Of Interest By Boundary
tags:
- Byboundary
x-contentType: application/json
x-accepts: application/json
components:
schemas:
AddressesByBoundaryRequest:
example:
travelDistanceUnit: travelDistanceUnit
preferences:
maxCandidates: maxCandidates
page: page
travelTime: travelTime
latitude: 6.027456183070403
travelTimeUnit: travelTimeUnit
travelDistance: travelDistance
geometry:
coordinates:
- 0.8008281904610115
- 0.8008281904610115
type: type
geometryAsText: geometryAsText
longitude: 1.4658129805029452
travelMode: travelMode
properties:
preferences:
$ref: '#/components/schemas/AddressesPreferences'
geometry:
$ref: '#/components/schemas/Geometry'
geometryAsText:
type: string
latitude:
format: double
type: number
longitude:
format: double
type: number
travelTime:
type: string
travelTimeUnit:
type: string
travelDistance:
type: string
travelDistanceUnit:
type: string
travelMode:
type: string
type: object
xml:
name: addressesByBoundaryRequest
Category:
example:
tradeGroup: tradeGroup
subClass: subClass
tradeDivision: tradeDivision
categoryCode: categoryCode
class: class
properties:
categoryCode:
type: string
tradeDivision:
type: string
tradeGroup:
type: string
subClass:
type: string
class:
type: string
type: object
ErrorInfo:
properties:
errors:
items:
$ref: '#/components/schemas/ErrorCode'
type: array
xml:
name: error
type: object
xml:
name: errors
poi:
example:
parentPbkey: parentPbkey
distance:
unit: unit
value: value
salesVolume:
- currencyCode: currencyCode
worldBaseCurrencyCode: worldBaseCurrencyCode
value: value
- currencyCode: currencyCode
worldBaseCurrencyCode: worldBaseCurrencyCode
value: value
hierarchyCode: hierarchyCode
businessId:
type: type
value: value
open24Hours: open24Hours
employeeCount:
inLocalBranch: inLocalBranch
inOrganization: inOrganization
subsidaryIndicator: subsidaryIndicator
domesticUltimateBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
globalUltimateBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
familyMembers: familyMembers
poiClassification:
alternateIndustryCode: alternateIndustryCode
sic:
sicCode: sicCode
primarySicCode: primarySicCode
businessLine: businessLine
sicCodeDescription: sicCodeDescription
secondarySicCode: secondarySicCode
category:
tradeGroup: tradeGroup
subClass: subClass
tradeDivision: tradeDivision
categoryCode: categoryCode
class: class
globalUltimateIndicator: globalUltimateIndicator
tradeName: tradeName
geocodeConfidence: geocodeConfidence
goodsAgentCodeDescription: goodsAgentCodeDescription
organizationStatusCodeDescription: organizationStatusCodeDescription
subsidaryIndicatorDescription: subsidaryIndicatorDescription
parentBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
id: id
poiId: poiId
ceoName: ceoName
yearStart: yearStart
franchiseName: franchiseName
brandName: brandName
tickerSymbol: tickerSymbol
contactDetails:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
phone: phone
countryAccessCode: countryAccessCode
fax: fax
email: email
url: url
ceoTitle: ceoTitle
goodsAgentCode: goodsAgentCode
organizationStatusCode: organizationStatusCode
relevanceScore: relevanceScore
pbkey: pbkey
name: name
exchangeName: exchangeName
geometry:
coordinates:
- 0.8008281904610115
- 0.8008281904610115
type: type
legalStatusCode: legalStatusCode
properties:
id:
type: string
poiId:
type: string
name:
type: string
pbkey:
type: string
parentPbkey:
type: string
geocodeConfidence:
type: string
brandName:
type: string
tradeName:
type: string
franchiseName:
type: string
open24Hours:
type: string
distance:
$ref: '#/components/schemas/distance'
businessId:
$ref: '#/components/schemas/businessId'
relevanceScore:
type: string
contactDetails:
$ref: '#/components/schemas/ContactDetails'
poiClassification:
$ref: '#/components/schemas/PoiClassification'
salesVolume:
items:
$ref: '#/components/schemas/salesVolume'
type: array
employeeCount:
$ref: '#/components/schemas/EmployeeCount'
yearStart:
type: string
goodsAgentCode:
type: string
goodsAgentCodeDescription:
type: string
legalStatusCode:
type: string
organizationStatusCode:
type: string
organizationStatusCodeDescription:
type: string
subsidaryIndicator:
type: string
subsidaryIndicatorDescription:
type: string
parentBusiness:
$ref: '#/components/schemas/ParentBusiness'
domesticUltimateBusiness:
$ref: '#/components/schemas/DomesticUltimateBusiness'
globalUltimateIndicator:
type: string
globalUltimateBusiness:
$ref: '#/components/schemas/GlobalUltimateBusiness'
familyMembers:
type: string
hierarchyCode:
type: string
tickerSymbol:
type: string
exchangeName:
type: string
ceoName:
type: string
ceoTitle:
type: string
geometry:
$ref: '#/components/schemas/Geometry'
type: object
addressesCount:
example:
totalAddressesFound: 0
properties:
totalAddressesFound:
format: int32
type: integer
type: object
xml:
name: addressesCount
AddressesPreferences:
example:
maxCandidates: maxCandidates
page: page
properties:
maxCandidates:
type: string
page:
type: string
type: object
Sic:
example:
sicCode: sicCode
primarySicCode: primarySicCode
businessLine: businessLine
sicCodeDescription: sicCodeDescription
secondarySicCode: secondarySicCode
properties:
businessLine:
type: string
sicCode:
type: string
sicCodeDescription:
type: string
primarySicCode:
type: string
secondarySicCode:
type: string
type: object
address_1:
example:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
properties:
objectId:
type: string
displayName:
type: string
streetSide:
type: string
businessName:
type: string
addressLine1:
type: string
addressLine2:
type: string
addressLine3:
type: string
city:
type: string
stateProvince:
type: string
county:
type: string
postalCode:
type: string
latitude:
type: string
longitude:
type: string
status:
type: string
urbanizationName:
type: string
formattedAddress:
type: string
mainAddressLine:
type: string
addressLastLine:
type: string
placeName:
type: string
areaName1:
type: string
areaName2:
type: string
areaName3:
type: string
areaName4:
type: string
postCode:
type: string
postCodeExt:
type: string
country:
type: string
addressNumber:
type: string
streetName:
type: string
unitType:
type: string
unitValue:
type: string
type: object
PlacesResponse:
example:
candidates: candidates
page: page
poi:
- parentPbkey: parentPbkey
distance:
unit: unit
value: value
salesVolume:
- currencyCode: currencyCode
worldBaseCurrencyCode: worldBaseCurrencyCode
value: value
- currencyCode: currencyCode
worldBaseCurrencyCode: worldBaseCurrencyCode
value: value
hierarchyCode: hierarchyCode
businessId:
type: type
value: value
open24Hours: open24Hours
employeeCount:
inLocalBranch: inLocalBranch
inOrganization: inOrganization
subsidaryIndicator: subsidaryIndicator
domesticUltimateBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
globalUltimateBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
familyMembers: familyMembers
poiClassification:
alternateIndustryCode: alternateIndustryCode
sic:
sicCode: sicCode
primarySicCode: primarySicCode
businessLine: businessLine
sicCodeDescription: sicCodeDescription
secondarySicCode: secondarySicCode
category:
tradeGroup: tradeGroup
subClass: subClass
tradeDivision: tradeDivision
categoryCode: categoryCode
class: class
globalUltimateIndicator: globalUltimateIndicator
tradeName: tradeName
geocodeConfidence: geocodeConfidence
goodsAgentCodeDescription: goodsAgentCodeDescription
organizationStatusCodeDescription: organizationStatusCodeDescription
subsidaryIndicatorDescription: subsidaryIndicatorDescription
parentBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
id: id
poiId: poiId
ceoName: ceoName
yearStart: yearStart
franchiseName: franchiseName
brandName: brandName
tickerSymbol: tickerSymbol
contactDetails:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
phone: phone
countryAccessCode: countryAccessCode
fax: fax
email: email
url: url
ceoTitle: ceoTitle
goodsAgentCode: goodsAgentCode
organizationStatusCode: organizationStatusCode
relevanceScore: relevanceScore
pbkey: pbkey
name: name
exchangeName: exchangeName
geometry:
coordinates:
- 0.8008281904610115
- 0.8008281904610115
type: type
legalStatusCode: legalStatusCode
- parentPbkey: parentPbkey
distance:
unit: unit
value: value
salesVolume:
- currencyCode: currencyCode
worldBaseCurrencyCode: worldBaseCurrencyCode
value: value
- currencyCode: currencyCode
worldBaseCurrencyCode: worldBaseCurrencyCode
value: value
hierarchyCode: hierarchyCode
businessId:
type: type
value: value
open24Hours: open24Hours
employeeCount:
inLocalBranch: inLocalBranch
inOrganization: inOrganization
subsidaryIndicator: subsidaryIndicator
domesticUltimateBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
globalUltimateBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
familyMembers: familyMembers
poiClassification:
alternateIndustryCode: alternateIndustryCode
sic:
sicCode: sicCode
primarySicCode: primarySicCode
businessLine: businessLine
sicCodeDescription: sicCodeDescription
secondarySicCode: secondarySicCode
category:
tradeGroup: tradeGroup
subClass: subClass
tradeDivision: tradeDivision
categoryCode: categoryCode
class: class
globalUltimateIndicator: globalUltimateIndicator
tradeName: tradeName
geocodeConfidence: geocodeConfidence
goodsAgentCodeDescription: goodsAgentCodeDescription
organizationStatusCodeDescription: organizationStatusCodeDescription
subsidaryIndicatorDescription: subsidaryIndicatorDescription
parentBusiness:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
name: name
id: id
id: id
poiId: poiId
ceoName: ceoName
yearStart: yearStart
franchiseName: franchiseName
brandName: brandName
tickerSymbol: tickerSymbol
contactDetails:
address:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
areaName1: areaName1
areaName2: areaName2
areaName3: areaName3
areaName4: areaName4
addressNumber: addressNumber
postCode: postCode
postCodeExt: postCodeExt
placeName: placeName
status: status
phone: phone
countryAccessCode: countryAccessCode
fax: fax
email: email
url: url
ceoTitle: ceoTitle
goodsAgentCode: goodsAgentCode
organizationStatusCode: organizationStatusCode
relevanceScore: relevanceScore
pbkey: pbkey
name: name
exchangeName: exchangeName
geometry:
coordinates:
- 0.8008281904610115
- 0.8008281904610115
type: type
legalStatusCode: legalStatusCode
totalMatchingCandidates: totalMatchingCandidates
matchedAddress:
country: country
streetSide: streetSide
city: city
displayName: displayName
postalCode: postalCode
latitude: latitude
businessName: businessName
county: county
unitType: unitType
streetName: streetName
formattedAddress: formattedAddress
addressLine1: addressLine1
mainAddressLine: mainAddressLine
addressLine2: addressLine2
addressLine3: addressLine3
objectId: objectId
addressLastLine: addressLastLine
longitude: longitude
unitValue: unitValue
stateProvince: stateProvince
urbanizationName: urbanizationName
# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/precisely-apis/refs/heads/main/openapi/precisely-apis-byboundary-api-openapi.yml