{
    "variable": [
        {
            "id": "baseUrl",
            "key": "baseUrl",
            "type": "string",
            "name": "string",
            "value": "https:\/\/developpers.isiquest.com"
        }
    ],
    "info": {
        "name": "isiQuest External API Documentation",
        "_postman_id": "54695f59-bd06-4abf-b37c-352dcea50675",
        "description": "Public API for isiQuest external clients (v1).",
        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json"
    },
    "item": [
        {
            "name": "Endpoints",
            "description": "",
            "item": [
                {
                    "name": "Check API availability.",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/health",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/health"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Returns a simple status payload confirming the external API is reachable.\nReference example endpoint for the API documentation setup.",
                        "auth": {
                            "type": "noauth"
                        }
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"status\": \"ok\",\n  \"version\": \"v1\"\n}",
                            "name": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Questionnaires",
            "description": "",
            "item": [
                {
                    "name": "List questionnaires.\n\nReturns a paginated list of questionnaires available to the authenticated client.",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/questionnaires",
                            "query": [
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "The page number to retrieve.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "20",
                                    "description": "Number of items per page (max 100).",
                                    "disabled": false
                                },
                                {
                                    "key": "status",
                                    "value": "active",
                                    "description": "Filter by status (draft, active, closed).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/questionnaires?page=1&per_page=20&status=active"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [\n    {\"id\": 101, \"title\": \"Employee engagement 2026\", \"status\": \"active\", \"responses_count\": 243},\n    {\"id\": 102, \"title\": \"Customer satisfaction Q1\", \"status\": \"closed\", \"responses_count\": 1890}\n  ],\n  \"meta\": {\"page\": 1, \"per_page\": 20, \"total\": 2}\n}",
                            "name": ""
                        }
                    ]
                },
                {
                    "name": "Retrieve a questionnaire.\n\nReturns the full detail of a single questionnaire, including its questions.",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/questionnaires\/:id",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/questionnaires\/:id",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": 101,
                                    "description": "The ID of the questionnaire."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"id\": 101,\n  \"title\": \"Employee engagement 2026\",\n  \"status\": \"active\",\n  \"language\": \"fr\",\n  \"questions\": [\n    {\"id\": 1, \"type\": \"single_choice\", \"label\": \"How satisfied are you?\"},\n    {\"id\": 2, \"type\": \"open\", \"label\": \"What would you improve?\"}\n  ]\n}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"message\": \"Questionnaire not found.\"}",
                            "name": ""
                        }
                    ]
                },
                {
                    "name": "Create a questionnaire.\n\nCreates a new questionnaire in draft status.",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/questionnaires",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/questionnaires"
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"title\":\"New onboarding survey\",\"language\":\"fr\",\"max_voters\":500}"
                        },
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 201,
                            "body": "{\n  \"id\": 103,\n  \"title\": \"New onboarding survey\",\n  \"status\": \"draft\",\n  \"language\": \"fr\"\n}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"message\": \"The title field is required.\", \"errors\": {\"title\": [\"The title field is required.\"]}}",
                            "name": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Responses",
            "description": "",
            "item": [
                {
                    "name": "List questionnaire responses.\n\nReturns the individual responses submitted for a given questionnaire.",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/questionnaires\/:id\/responses",
                            "query": [
                                {
                                    "key": "since",
                                    "value": "2026-01-01",
                                    "description": "date Only responses submitted after this date (ISO 8601).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/questionnaires\/:id\/responses?since=2026-01-01",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": 101,
                                    "description": "The ID of the questionnaire."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [\n    {\"response_id\": \"r_8812\", \"submitted_at\": \"2026-02-14T10:03:00Z\", \"completed\": true},\n    {\"response_id\": \"r_8813\", \"submitted_at\": \"2026-02-14T11:20:00Z\", \"completed\": false}\n  ],\n  \"meta\": {\"total\": 2}\n}",
                            "name": ""
                        }
                    ]
                },
                {
                    "name": "Submit a response.\n\nSubmits a completed response to a questionnaire on behalf of a respondent.",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/questionnaires\/:id\/responses",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/questionnaires\/:id\/responses",
                            "variable": [
                                {
                                    "id": "id",
                                    "key": "id",
                                    "value": 101,
                                    "description": "The ID of the questionnaire."
                                }
                            ]
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\"respondent_email\":\"jane@example.com\",\"answers\":{\"1\":\"Very satisfied\",\"2\":\"Faster onboarding\"}}"
                        },
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 201,
                            "body": "{\n  \"response_id\": \"r_8900\",\n  \"questionnaire_id\": 101,\n  \"status\": \"recorded\"\n}",
                            "name": ""
                        }
                    ]
                }
            ]
        }
    ],
    "auth": {
        "type": "bearer",
        "bearer": [
            {
                "key": "Authorization",
                "type": "string"
            }
        ]
    }
}