Skip to content
English
Submit A Ticket Customer Portal
LOGIN
  • There are no suggestions because the search field is empty.

Pisano External API - Flows - Active Survey Query

Active Survey Query

Retrieves customer specific active surveys.

POST /external/v1/nodes/{node_id}/active_surveys

Authentication

Authentication Method Bearer Token

Request

Path Parameters

Parameter Type Required Description Example
node_id string Yes Pisano node ID. Pisano provides dedicated IDs for the configured domains/units. <node_id>

Headers

Header Required Description Example
Accept application/json
Content-Type application/json
Authorization Yes Integration token. Bearer <Token>

Request Body

{
  "customer": {
    "phone_number": "<phone_number>",
    "external_id": "<external_id>",
    "email": "test@example.com",
    "schema": {
      "TCKN": "<TCKN>"
    }
  },
  "response_channel_id": "<response_channel_id>"
}

Request Body Fields

Field Type Required Description Example
customer.phone_number string Optional MSISDN number. Can be used to query active surveys associated with the customer. <phone_number>
customer.email string Optional Customer email address. Can be used to query active surveys associated with the customer. test@example.com
customer.external_id string Optional External/customer service identifier configured as the unique customer ID in Pisano. <external_id>
customer.schema.TCKN string Optional Identity number value sent inside the schema object. <TCKN>
response_channel_id string Optional Channel ID to which the response will be associated. Pisano provides the GUID. <response_channel_id>

Request Example

cURL Request Example 
curl --location --request POST \
'<API_URL>/external/v1/nodes/<node_id>/active_surveys' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <Token>' \
--data '{
  "customer": {
    "phone_number": "<phone_number>",
    "external_id": "<external_id>",
    "email": "test@example.com",
    "schema": {
      "TCKN": "<TCKN>"
    }
  },
  "response_channel_id": "<response_channel_id>"
}'

Responses

200 OK

Response Fields

Field Type Required Description Example
Link Active survey link. anket1.psn.vc
SurveyName Name of the active survey. Anket 1
LastActivationDate Last activation date of the customer specific link. 10.04.2026 12:45:05
UnitName Associated domain/unit information. Mobil

Response Example

JSON Response Example 
{
  "count": 3,
  "surveys": [
    {
      "Link": "anket1.psn.vc",
      "SurveyName": "Anket 1",
      "LastActivationDate": "10.04.2026 12:45:05",
      "UnitName": "Mobil"
    },
    {
      "Link": "anket2.psn.vc",
      "SurveyName": "Anket 2",
      "LastActivationDate": "20.04.2026 12:45:05",
      "UnitName": "Mobil"
    },
    {
      "Link": "anket3.psn.vc",
      "SurveyName": "Anket 3",
      "LastActivationDate": "15.04.2026 12:45:05",
      "UnitName": "Mobil"
    }
  ]
}

Additional Information

Usage Limitations At least one of phone_number, email, or external_id can be used in the request. If more than one is provided, the values are combined with AND and the active surveys of the matching customer are returned.
Notes The API base URL is environment specific and is shared separately for Test and PROD.

LastActivationDate format: %d.%m.%Y %H:%M:%S (example: 10.04.2026 12:45:05).