NOTE: this API is only available to Griffin View & Griffin View ASM Edition subscribers with a non-commercial use license. Contact us for details.

ASD Pivot Query APIv1

Using curl

Call with default parameters:

curl -H 'Content-Type: application/json' -H 'X-Api-Key: YOUR_APIKEY' -XPOST 'https://www.onyphe.io/api/v1/asd/pivot/query' -d '{ "query":"category:datascan domain:DOMAIN.TLD","field":"subject.organization" }'

Call with some custom parameters:

curl -H 'Content-Type: application/json' -H 'X-Api-Key: YOUR_APIKEY' -XPOST 'https://www.onyphe.io/api/v1/asd/pivot/query' -d '{ "query":"category:datascan domain:DOMAIN.TLD","field":"subject.organization","aslines":"true" }'

Available parameters

• query: OQL query to execute. Mandatory parameter.
• field: field to pivot on. Mandatory parameter.
• aslines: render results with context information (false) or one JSON per line (true). Default to false.
• astask: create a background task for later processing (true). Default to false.
• includep: one or more patterns to grep into result values and only keep matches.
• excludep: one or more patterns to grep into result values and exclude matches.

Using ONYPHE CLI

onyphe -asd-pivot-query 'category:datascan domain:DOMAIN.TLD' -field subject.organization

Error codes

error: 0, text: 'success'
error: 1, text: 'internal failure'
error: 2, text: 'request timed out'
error: 3, text: 'connection refused'
error: 4, text: 'unable to fork a new process'
error: 1000, text: 'API not found'
error: 1001, text: 'API access denied'
error: 1002, text: 'parameter error'
error: 1003, text: 'user not found'
error: 1004, text: 'user get failed'
error: 1005, text: 'no more credits'
error: 1006, text: 'search failed'
error: 1007, text: 'task not found'
error: 1008, text: 'creating task failed'
error: 1009, text: 'getting task result failed'
error: 1010, text: 'task in progress'
error: 1011, text: 'too many results, you should create a task'
error: 1012, text: 'unable to kill task'
error: 1013, text: 'resolver failed'