PAGES

← Censys

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

first call
$ 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

Endpoints

109 of 109

Open an endpoint for a runnable command, its inputs and what it returns.

Global Data 25

  • GET /v3/global/asset/certificate Retrieve multiple certificates deprecated

    Loading…

  • GET /v3/global/asset/certificate/raw Retrieve multiple certificates in PEM format deprecated

    Loading…

  • GET /v3/global/asset/certificate/{certificate_id} Get a certificate

    Loading…

  • GET /v3/global/asset/certificate/{certificate_id}/raw Get a certificate in PEM format

    Loading…

  • GET /v3/global/asset/enrichment/host/{host_ip} Get host enrichment

    Loading…

  • GET /v3/global/asset/host Retrieve multiple hosts deprecated

    Loading…

  • GET /v3/global/asset/host/{host_id} Get a host

    Loading…

  • GET /v3/global/asset/host/{host_id}/observations/services Get service history for a host

    Loading…

  • GET /v3/global/asset/host/{host_id}/timeline Get host event history

    Loading…

  • GET /v3/global/asset/webproperty Retrieve multiple web properties deprecated

    Loading…

  • GET /v3/global/asset/webproperty/{webproperty_id} Get a web property

    Loading…

  • GET /v3/global/asset/webproperty/{webproperty_id}/timeline Get web property event history

    Loading…

  • GET /v3/global/dns/resolutions/ip/{ip}/bounds Get DNS names that resolved to an IP (aggregated bounds)

    Loading…

  • GET /v3/global/dns/resolutions/ip/{ip}/ranges Get DNS names that resolved to an IP (ranges)

    Loading…

  • GET /v3/global/dns/resolutions/{name}/bounds Get DNS resolution records for a name (aggregated bounds)

    Loading…

  • GET /v3/global/dns/resolutions/{name}/ranges Get DNS resolution records for a name (ranges)

    Loading…

  • GET /v3/global/scans/{scan_id} Get scan status

    Loading…

  • POST /v3/global/asset/certificate Retrieve multiple certificates

    Loading…

  • POST /v3/global/asset/certificate/raw Retrieve multiple certificates in PEM format

    Loading…

  • POST /v3/global/asset/host Retrieve multiple hosts

    Loading…

  • POST /v3/global/asset/webproperty Retrieve multiple web properties

    Loading…

  • POST /v3/global/scans/rescan Live Rescan: Initiate a new rescan

    Loading…

  • POST /v3/global/search/aggregate Aggregate results for a search query

    Loading…

  • POST /v3/global/search/convert Convert Legacy Search queries to Platform queries

    Loading…

  • POST /v3/global/search/query Run a search query

    Loading…

Threat Hunting 19

  • GET /v3/threat-hunting/censeye/jobs CensEye: List jobs

    Loading…

  • GET /v3/threat-hunting/censeye/jobs/{job_id} CensEye: Get job status

    Loading…

  • GET /v3/threat-hunting/censeye/jobs/{job_id}/results CensEye: Get job results

    Loading…

  • GET /v3/threat-hunting/certificate/{certificate_id}/observations/hosts Get host history for a certificate

    Loading…

  • GET /v3/threat-hunting/host/{ip}/observations/endpoints Get endpoint observation history for a host

    Loading…

  • GET /v3/threat-hunting/host/{ip}/observations/fingerprints Get fingerprint observation history for a host

    Loading…

  • GET /v3/threat-hunting/host/{ip}/observations/threats Get threat history for a host

    Loading…

  • GET /v3/threat-hunting/investigations/jobs Investigations: List jobs

    Loading…

  • GET /v3/threat-hunting/investigations/jobs/{job_id} Investigations: Get job status

    Loading…

  • GET /v3/threat-hunting/investigations/jobs/{job_id}/results Investigations: Get job results

    Loading…

  • GET /v3/threat-hunting/investigations/usage Investigations: Get usage

    Loading…

  • GET /v3/threat-hunting/scans/{scan_id} Get scan status

    Loading…

  • GET /v3/threat-hunting/threats List active threats

    Loading…

  • GET /v3/threat-hunting/web/{webproperty_id}/observations/threats Get threat history for a web property

    Loading…

  • POST /v3/threat-hunting/censeye/jobs CensEye: Create a pivot analysis job

    Loading…

  • POST /v3/threat-hunting/investigations/files Investigations: Create file upload

    Loading…

  • POST /v3/threat-hunting/investigations/jobs Investigations: Create job

    Loading…

  • POST /v3/threat-hunting/scans/discovery Live Discovery: Initiate a new scan

    Loading…

  • POST /v3/threat-hunting/value-counts CensEye: Retrieve value counts to discover pivots

    Loading…

Tags And Comments 17

  • DELETE /v3/comments/{comment_id} Delete a comment

    Loading…

  • DELETE /v3/tags/{tag_id} Delete a tag

    Loading…

  • DELETE /v3/tags/{tag_id}/assignments/{assignment_id} Delete a tag assignment

    Loading…

  • GET /v3/comments List comments

    Loading…

  • GET /v3/tags List tags

    Loading…

  • GET /v3/tags/{tag_id} Get a tag

    Loading…

  • GET /v3/tags/{tag_id}/assignments List tag assignments

    Loading…

  • GET /v3/tags/{tag_id}/operations List tag operations

    Loading…

  • GET /v3/tags/{tag_id}/operations/{operation_id} Get a tag operation

    Loading…

  • POST /v3/comments Create a comment

    Loading…

  • POST /v3/tags Create a tag

    Loading…

  • POST /v3/tags/{tag_id}/assignments Create a tag assignment

    Loading…

  • POST /v3/tags/{tag_id}/assignments/bulk-create Bulk create tag assignments

    Loading…

  • POST /v3/tags/{tag_id}/assignments/bulk-delete Bulk delete tag assignments

    Loading…

  • POST /v3/tags/{tag_id}/operations/{operation_id}/cancel Cancel a tag operation

    Loading…

  • PUT /v3/comments/{comment_id} Update a comment

    Loading…

  • PUT /v3/tags/{tag_id} Update a tag

    Loading…

Supplier Risk 14

  • DELETE /v1/supplychains/{supply_chain_id}/suppliers/{supplier_id} Remove a supplier from your supply chain

    Loading…

  • GET /v1/supplychains List supply chains

    Loading…

  • GET /v1/supplychains/suppliers Search suppliers

    Loading…

  • GET /v1/supplychains/{supply_chain_id} Get supply chain

    Loading…

  • GET /v1/supplychains/{supply_chain_id}/risk-events List risk events

    Loading…

  • GET /v1/supplychains/{supply_chain_id}/risk-instances List risk instances

    Loading…

  • GET /v1/supplychains/{supply_chain_id}/risk-instances/{risk_instance_id} Get risk instance

    Loading…

  • GET /v1/supplychains/{supply_chain_id}/risks List risks

    Loading…

  • GET /v1/supplychains/{supply_chain_id}/security-advisories List supply chain security advisories

    Loading…

  • GET /v1/supplychains/{supply_chain_id}/suppliers List suppliers

    Loading…

  • GET /v1/supplychains/{supply_chain_id}/suppliers/{supplier_id} Get supplier

    Loading…

  • POST /v1/supplychains/{supply_chain_id}/assets/aggregate Aggregate supply chain assets

    Loading…

  • POST /v1/supplychains/{supply_chain_id}/assets/search Search supply chain assets

    Loading…

  • POST /v1/supplychains/{supply_chain_id}/suppliers Add suppliers to a supply chain

    Loading…

Account Management 13

  • DELETE /v3/accounts/organizations/{organization_id}/members/{user_id} Remove user from organization

    Loading…

  • DELETE /v3/accounts/organizations/{organization_id}/members/{user_id}/modules/{module} Remove a user's module access

    Loading…

  • GET /v3/accounts/organizations/{organization_id} Get organization details

    Loading…

  • GET /v3/accounts/organizations/{organization_id}/audit-log-events List audit log events

    Loading…

  • GET /v3/accounts/organizations/{organization_id}/credits Get organization credit balance

    Loading…

  • GET /v3/accounts/organizations/{organization_id}/credits/usage Get organization credit usage

    Loading…

  • GET /v3/accounts/organizations/{organization_id}/members List organization users

    Loading…

  • GET /v3/accounts/organizations/{organization_id}/members/{user_id}/credits/usage Get organization user credit usage

    Loading…

  • GET /v3/accounts/users/credits Get Free user credit balance

    Loading…

  • GET /v3/accounts/users/credits/usage Get Free user credit usage

    Loading…

  • PATCH /v3/accounts/organizations/{organization_id}/members/{user_id} Update a user's Platform-wide roles in an organization

    Loading…

  • POST /v3/accounts/organizations/{organization_id}/invitations Invite user to organization

    Loading…

  • PUT /v3/accounts/organizations/{organization_id}/members/{user_id}/modules/{module} Set a user's module role

    Loading…

Exposure Management 13

  • DELETE /v1/attacksurfaces/{attack_surface_id} Delete an attack surface

    Loading…

  • DELETE /v1/attacksurfaces/{attack_surface_id}/assets/{asset} Remove an asset from an attack surface

    Loading…

  • DELETE /v1/attacksurfaces/{attack_surface_id}/excludes/{asset} Remove an exclusion from an attack surface

    Loading…

  • GET /v1/attacksurfaces List attack surfaces

    Loading…

  • GET /v1/attacksurfaces/{attack_surface_id} Get an attack surface

    Loading…

  • GET /v1/attacksurfaces/{attack_surface_id}/assets List the assets of an attack surface

    Loading…

  • GET /v1/attacksurfaces/{attack_surface_id}/excludes List the exclusions of an attack surface

    Loading…

  • GET /v1/attacksurfaces/{attack_surface_id}/risk-events List attack surface risk events

    Loading…

  • POST /v1/attacksurfaces Create an attack surface

    Loading…

  • POST /v1/attacksurfaces/{attack_surface_id}/aggregate Aggregate attack surface assets

    Loading…

  • POST /v1/attacksurfaces/{attack_surface_id}/assets Add assets to an attack surface

    Loading…

  • POST /v1/attacksurfaces/{attack_surface_id}/excludes Exclude assets from an attack surface

    Loading…

  • POST /v1/attacksurfaces/{attack_surface_id}/search Search attack surface assets

    Loading…

Collections 8

  • DELETE /v3/collections/{collection_uid} Delete a collection

    Loading…

  • GET /v3/collections List collections

    Loading…

  • GET /v3/collections/{collection_uid} Get a collection

    Loading…

  • GET /v3/collections/{collection_uid}/events Get a collection's events

    Loading…

  • POST /v3/collections Create a collection

    Loading…

  • POST /v3/collections/{collection_uid}/search/aggregate Aggregate results for a search query within a collection

    Loading…

  • POST /v3/collections/{collection_uid}/search/query Run a search query within a collection

    Loading…

  • PUT /v3/collections/{collection_uid} Update a collection

    Loading…

Saved in this browser. Sign in to sync your tools.