API Reference

List tag assignments

get
https://api.platform.censys.io/v3/tags//assignments

Retrieve a paginated list of assignments for a tag in your organization. Use query parameters to filter results by asset, created_by, or creation time. Only assignments for tags visible to your account are returned.

This endpoint does not cost any credits to execute.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

The ID of the tag whose assignments to list.

Query Params
uuid
required

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

int32
1 to 1000
Defaults to 100

Number of assignments to return per page.

string

Pagination token from a previous response to retrieve the next page of results.

string
enum
Defaults to create_time_desc

Sort order. Supported values: create_time_asc, create_time_desc.

Allowed:
string

The identifier of the asset to tag (host IP, certificate SHA-256 fingerprint, or web property hostname:port).

date-time

RFC3339 timestamp. Only return assignments created before this time.

date-time

RFC3339 timestamp. Only return assignments created after this time.

uuid

Filter by the user ID of the user who created the assignment.

Headers
uuid

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 3 hours ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 3 hours ago