Censys — API
Censys Platform APIv1.0.163 Read the vendor's spec ↗
- 109 endpoints
- 4 deprecated
- 2 versions archived since Nov 11, 2026
- Last checked Nov 14, 2026
Get started
$ curl "https://api.platform.censys.io/v3/accounts/users/credits" \
-H "Authorization: Bearer $TOKEN"
Set $TOKEN first, then paste.
- Base URL
-
https://api.platform.censys.io - Authenticate
- Bearer token in the Authorization header Your Censys personal access token.
What it covers
- Global Data 25 Endpoints related to the Global Data product
- Threat Hunting 19 Endpoints related to the Adversary Investigation product
- Tags And Comments 17 Endpoints related to asset tagging and commenting
- Supplier Risk 14 Endpoints related to the Supplier Risk product
- Account Management 13 Endpoints related to the Account Management product
- Exposure Management 13 Endpoints related to the Exposure Management product
- Collections 8 Endpoints related to the Collections product
Open an endpoint for a runnable command, its inputs and what it returns.
Global Data 25
-
GET
/v3/global/asset/certificateRetrieve multiple certificates deprecatedLoading…
-
GET
/v3/global/asset/certificate/rawRetrieve multiple certificates in PEM format deprecatedLoading…
-
GET
/v3/global/asset/certificate/{certificate_id}Get a certificateLoading…
-
GET
/v3/global/asset/certificate/{certificate_id}/rawGet a certificate in PEM formatLoading…
-
GET
/v3/global/asset/enrichment/host/{host_ip}Get host enrichmentLoading…
-
GET
/v3/global/asset/hostRetrieve multiple hosts deprecatedLoading…
-
GET
/v3/global/asset/host/{host_id}Get a hostLoading…
-
GET
/v3/global/asset/host/{host_id}/observations/servicesGet service history for a hostLoading…
-
GET
/v3/global/asset/host/{host_id}/timelineGet host event historyLoading…
-
GET
/v3/global/asset/webpropertyRetrieve multiple web properties deprecatedLoading…
-
GET
/v3/global/asset/webproperty/{webproperty_id}Get a web propertyLoading…
-
GET
/v3/global/asset/webproperty/{webproperty_id}/timelineGet web property event historyLoading…
-
GET
/v3/global/dns/resolutions/ip/{ip}/boundsGet DNS names that resolved to an IP (aggregated bounds)Loading…
-
GET
/v3/global/dns/resolutions/ip/{ip}/rangesGet DNS names that resolved to an IP (ranges)Loading…
-
GET
/v3/global/dns/resolutions/{name}/boundsGet DNS resolution records for a name (aggregated bounds)Loading…
-
GET
/v3/global/dns/resolutions/{name}/rangesGet DNS resolution records for a name (ranges)Loading…
-
GET
/v3/global/scans/{scan_id}Get scan statusLoading…
-
POST
/v3/global/asset/certificateRetrieve multiple certificatesLoading…
-
POST
/v3/global/asset/certificate/rawRetrieve multiple certificates in PEM formatLoading…
-
POST
/v3/global/asset/hostRetrieve multiple hostsLoading…
-
POST
/v3/global/asset/webpropertyRetrieve multiple web propertiesLoading…
-
POST
/v3/global/scans/rescanLive Rescan: Initiate a new rescanLoading…
-
POST
/v3/global/search/aggregateAggregate results for a search queryLoading…
-
POST
/v3/global/search/convertConvert Legacy Search queries to Platform queriesLoading…
-
POST
/v3/global/search/queryRun a search queryLoading…
Threat Hunting 19
-
GET
/v3/threat-hunting/censeye/jobsCensEye: List jobsLoading…
-
GET
/v3/threat-hunting/censeye/jobs/{job_id}CensEye: Get job statusLoading…
-
GET
/v3/threat-hunting/censeye/jobs/{job_id}/resultsCensEye: Get job resultsLoading…
-
GET
/v3/threat-hunting/certificate/{certificate_id}/observations/hostsGet host history for a certificateLoading…
-
GET
/v3/threat-hunting/host/{ip}/observations/endpointsGet endpoint observation history for a hostLoading…
-
GET
/v3/threat-hunting/host/{ip}/observations/fingerprintsGet fingerprint observation history for a hostLoading…
-
GET
/v3/threat-hunting/host/{ip}/observations/threatsGet threat history for a hostLoading…
-
GET
/v3/threat-hunting/investigations/jobsInvestigations: List jobsLoading…
-
GET
/v3/threat-hunting/investigations/jobs/{job_id}Investigations: Get job statusLoading…
-
GET
/v3/threat-hunting/investigations/jobs/{job_id}/resultsInvestigations: Get job resultsLoading…
-
GET
/v3/threat-hunting/investigations/usageInvestigations: Get usageLoading…
-
GET
/v3/threat-hunting/scans/{scan_id}Get scan statusLoading…
-
GET
/v3/threat-hunting/threatsList active threatsLoading…
-
GET
/v3/threat-hunting/web/{webproperty_id}/observations/threatsGet threat history for a web propertyLoading…
-
POST
/v3/threat-hunting/censeye/jobsCensEye: Create a pivot analysis jobLoading…
-
POST
/v3/threat-hunting/investigations/filesInvestigations: Create file uploadLoading…
-
POST
/v3/threat-hunting/investigations/jobsInvestigations: Create jobLoading…
-
POST
/v3/threat-hunting/scans/discoveryLive Discovery: Initiate a new scanLoading…
-
POST
/v3/threat-hunting/value-countsCensEye: Retrieve value counts to discover pivotsLoading…
Tags And Comments 17
-
DELETE
/v3/comments/{comment_id}Delete a commentLoading…
-
DELETE
/v3/tags/{tag_id}Delete a tagLoading…
-
DELETE
/v3/tags/{tag_id}/assignments/{assignment_id}Delete a tag assignmentLoading…
-
GET
/v3/commentsList commentsLoading…
-
GET
/v3/tagsList tagsLoading…
-
GET
/v3/tags/{tag_id}Get a tagLoading…
-
GET
/v3/tags/{tag_id}/assignmentsList tag assignmentsLoading…
-
GET
/v3/tags/{tag_id}/operationsList tag operationsLoading…
-
GET
/v3/tags/{tag_id}/operations/{operation_id}Get a tag operationLoading…
-
POST
/v3/commentsCreate a commentLoading…
-
POST
/v3/tagsCreate a tagLoading…
-
POST
/v3/tags/{tag_id}/assignmentsCreate a tag assignmentLoading…
-
POST
/v3/tags/{tag_id}/assignments/bulk-createBulk create tag assignmentsLoading…
-
POST
/v3/tags/{tag_id}/assignments/bulk-deleteBulk delete tag assignmentsLoading…
-
POST
/v3/tags/{tag_id}/operations/{operation_id}/cancelCancel a tag operationLoading…
-
PUT
/v3/comments/{comment_id}Update a commentLoading…
-
PUT
/v3/tags/{tag_id}Update a tagLoading…
Supplier Risk 14
-
DELETE
/v1/supplychains/{supply_chain_id}/suppliers/{supplier_id}Remove a supplier from your supply chainLoading…
-
GET
/v1/supplychainsList supply chainsLoading…
-
GET
/v1/supplychains/suppliersSearch suppliersLoading…
-
GET
/v1/supplychains/{supply_chain_id}Get supply chainLoading…
-
GET
/v1/supplychains/{supply_chain_id}/risk-eventsList risk eventsLoading…
-
GET
/v1/supplychains/{supply_chain_id}/risk-instancesList risk instancesLoading…
-
GET
/v1/supplychains/{supply_chain_id}/risk-instances/{risk_instance_id}Get risk instanceLoading…
-
GET
/v1/supplychains/{supply_chain_id}/risksList risksLoading…
-
GET
/v1/supplychains/{supply_chain_id}/security-advisoriesList supply chain security advisoriesLoading…
-
GET
/v1/supplychains/{supply_chain_id}/suppliersList suppliersLoading…
-
GET
/v1/supplychains/{supply_chain_id}/suppliers/{supplier_id}Get supplierLoading…
-
POST
/v1/supplychains/{supply_chain_id}/assets/aggregateAggregate supply chain assetsLoading…
-
POST
/v1/supplychains/{supply_chain_id}/assets/searchSearch supply chain assetsLoading…
-
POST
/v1/supplychains/{supply_chain_id}/suppliersAdd suppliers to a supply chainLoading…
Account Management 13
-
DELETE
/v3/accounts/organizations/{organization_id}/members/{user_id}Remove user from organizationLoading…
-
DELETE
/v3/accounts/organizations/{organization_id}/members/{user_id}/modules/{module}Remove a user's module accessLoading…
-
GET
/v3/accounts/organizations/{organization_id}Get organization detailsLoading…
-
GET
/v3/accounts/organizations/{organization_id}/audit-log-eventsList audit log eventsLoading…
-
GET
/v3/accounts/organizations/{organization_id}/creditsGet organization credit balanceLoading…
-
GET
/v3/accounts/organizations/{organization_id}/credits/usageGet organization credit usageLoading…
-
GET
/v3/accounts/organizations/{organization_id}/membersList organization usersLoading…
-
GET
/v3/accounts/organizations/{organization_id}/members/{user_id}/credits/usageGet organization user credit usageLoading…
-
GET
/v3/accounts/users/creditsGet Free user credit balanceLoading…
-
GET
/v3/accounts/users/credits/usageGet Free user credit usageLoading…
-
PATCH
/v3/accounts/organizations/{organization_id}/members/{user_id}Update a user's Platform-wide roles in an organizationLoading…
-
POST
/v3/accounts/organizations/{organization_id}/invitationsInvite user to organizationLoading…
-
PUT
/v3/accounts/organizations/{organization_id}/members/{user_id}/modules/{module}Set a user's module roleLoading…
Exposure Management 13
-
DELETE
/v1/attacksurfaces/{attack_surface_id}Delete an attack surfaceLoading…
-
DELETE
/v1/attacksurfaces/{attack_surface_id}/assets/{asset}Remove an asset from an attack surfaceLoading…
-
DELETE
/v1/attacksurfaces/{attack_surface_id}/excludes/{asset}Remove an exclusion from an attack surfaceLoading…
-
GET
/v1/attacksurfacesList attack surfacesLoading…
-
GET
/v1/attacksurfaces/{attack_surface_id}Get an attack surfaceLoading…
-
GET
/v1/attacksurfaces/{attack_surface_id}/assetsList the assets of an attack surfaceLoading…
-
GET
/v1/attacksurfaces/{attack_surface_id}/excludesList the exclusions of an attack surfaceLoading…
-
GET
/v1/attacksurfaces/{attack_surface_id}/risk-eventsList attack surface risk eventsLoading…
-
POST
/v1/attacksurfacesCreate an attack surfaceLoading…
-
POST
/v1/attacksurfaces/{attack_surface_id}/aggregateAggregate attack surface assetsLoading…
-
POST
/v1/attacksurfaces/{attack_surface_id}/assetsAdd assets to an attack surfaceLoading…
-
POST
/v1/attacksurfaces/{attack_surface_id}/excludesExclude assets from an attack surfaceLoading…
-
POST
/v1/attacksurfaces/{attack_surface_id}/searchSearch attack surface assetsLoading…
Collections 8
-
DELETE
/v3/collections/{collection_uid}Delete a collectionLoading…
-
GET
/v3/collectionsList collectionsLoading…
-
GET
/v3/collections/{collection_uid}Get a collectionLoading…
-
GET
/v3/collections/{collection_uid}/eventsGet a collection's eventsLoading…
-
POST
/v3/collectionsCreate a collectionLoading…
-
POST
/v3/collections/{collection_uid}/search/aggregateAggregate results for a search query within a collectionLoading…
-
POST
/v3/collections/{collection_uid}/search/queryRun a search query within a collectionLoading…
-
PUT
/v3/collections/{collection_uid}Update a collectionLoading…
No endpoint matches. Clear the filter to see all 109.