Skip to content
/
Get supplier's questionna...

papi (2)

Panorays Public API

Download OpenAPI description
swagger.json
swagger.yaml
Overview
Support
support@panorays.com
Languages
Servers
Mock server
https://panorays-papi-v2-documentation.redocly.app/_mock/swagger
https://api.panoraysapp.com

Supplier

Use these routes to access and update your suppliers.

Operations

Segment

Operations

Posture

Operations

Portfolio

Operations

Asset

Operations

Finding

Operations

RemediationTasks

Operations

BusinessInformation

Operations

File

Operations

Questionnaire

Operations

Put Segment Questionnaire

Request

This endpoint will extend due date of a segment questionnaire.

Security
bearer
Path
supplierIdstringrequired

Id of the supplier

questionnaireIdstringrequired

Id of the questionnaire

segmentIdstringrequired

Id of the segment

Bodyapplication/jsonrequired
notestring

note from the evaluator to the supplier, that will be sent with the questionnaire

ttlobject

ttl is the due date specified by the the evaluator. defaults to 30 days from now

Default "2026-02-11T08:41:54.837Z"
questionnaire_typestring

Type of the questionnaire

Default "external"
Enum"internal""external"
curl -i -X PUT \
  'https://panorays-papi-v2-documentation.redocly.app/_mock/swagger/v2/suppliers/{supplierId}/segment/{segmentId}/questionnaires/{questionnaireId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "note": "string",
    "ttl": "2026-02-11T08:41:54.837Z",
    "questionnaire_type": "internal"
  }'

Responses

Questionnaire.

Bodyapplication/json
questionnaire_idobjectrequired
statusstringrequired
ttlstring(date-time)required
template_namestringrequired
weightnumberrequired
created_bystringrequired
status_update_datestring(date-time)required
completion_ratenumberrequired
questionnaire_typestringrequired
Response
application/json
{
  "questionnaire_id": {},
  "status": "string",
  "ttl": "2019-08-24T14:15:22Z",
  "template_name": "string",
  "weight": 0,
  "created_by": "string",
  "status_update_date": "2019-08-24T14:15:22Z",
  "completion_rate": 0,
  "questionnaire_type": "string"
}

Get supplier's questionnaire report

Request

This endpoint will return pdf with questionnaire report.

Security
bearer
Path
supplierIdstringrequired
templateNamestringrequired
Query
langstring

Report language

Enum"en""ja"
isConfidentialboolean

Optional - set to true if you want to get confidential pdf (including questions, answers, scores, comments & notes, and tags & relationships) (false | true) -> false is the default (including only questions, answers and conversation with suppliers)

questionnaireIdstring
curl -i -X GET \
  'https://panorays-papi-v2-documentation.redocly.app/_mock/swagger/v2/suppliers/{supplierId}/report/questionnaire/{templateName}?lang=en&isConfidential=true&questionnaireId=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Report has been found

Post questionnaire

Request

This endpoint will send questionnaire to supplier.

Security
bearer
Path
supplierIdstringrequired

Id of the supplier

templateIdstring

name of the template to use for the questionnaire. Needs to be provided for sending a questionnaire. I's called "templateId" to not confuse the users with "display_name"

Bodyapplication/jsonrequired
pocsArray of strings(email)required
template_idstring

name of the template to use for the questionnaire. If not provided the latest template will be sent. For information regarding which template is the latest one, please contact Panorays Support.

notestring

note from the evaluator to the supplier, that will be sent with the questionnaire

ttlstring(date-time)

ttl is the due date specified by the the evaluator

questionnaire_typestring

Questionnaire type - internal/external

Default "external"
Enum"external""internal""both"
curl -i -X POST \
  'https://panorays-papi-v2-documentation.redocly.app/_mock/swagger/v2/suppliers/{supplierId}/questionnaires/{templateId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "pocs": [
      "user@example.com"
    ],
    "template_id": "string",
    "note": "string",
    "ttl": "2019-08-24T14:15:22Z",
    "questionnaire_type": "external"
  }'

Responses

Questionnaire.

Bodyapplication/json
ttlstring or nullrequired
idobjectrequired
insert_tsstring(date-time)required
pocsArray of objectsrequired
statusstringrequired
template_idstringrequired
template_namestringrequired
Response
application/json
{
  "ttl": "string",
  "id": {},
  "insert_ts": "2019-08-24T14:15:22Z",
  "pocs": [
    {}
  ],
  "status": "string",
  "template_id": "string",
  "template_name": "string"
}

RiskInsights

Operations

BusinessSnapshot

Operations

Relationship

Operations

Licenses

Operations

Templates

Operations

Activity Center

Operations

Tags

Tag actions (Create, Delete, Get, Update) apply to company tags only. Tags can’t be updated via the supplier endpoint, as they may link to multiple suppliers. When a company tag is updated/deleted, all associated suppliers are automatically updated — no separate supplier update is needed.

Operations

Factors

Operations

CyberNewsArticles

Operations

DarkWebMentions

Operations

ReEvaluation

Operations

Webhooks Intro

The hook api provides a simple way of registering to events that happen with your suppliers

Getting Started

The following steps will walk you through the process of registering and reacting to webhooks.

  1. Register an API token

If you don’t already have an API token, you can generate one through Panorays platform or contact Panorays Support at support@panorays.com.

  1. Register your app

Before you can start receiving events, register your application with Panorays using the Handshake API call.

  1. Subscribe to relevant events

You will only receive event calls for events you subscribe to using the Subscribe API call.
Note: You can unsubscribe at any time using the Unsubscribe API call.

  1. Start receiving events

You're done! From now on, you will receive notifications for every event you subscribed to.

To learn how to secure your app and ensure you handle events only from Panorays, read about Verifying requests.

Verify Requests

Panorays signs every request with a secret that's unique to your service account, using this secret you can verify that the incoming request arrived from Panorays servers.

Handshake

Operations

Subscription

Operations