> ## Documentation Index > Fetch the complete documentation index at: https://docs.energy.nayax.com/llms.txt > Use this file to discover all available pages before exploring further. # List an incident's affected stations (roster) > The incident's roster, keyset-paginated, with live station data joined in. Each row's status (AFFECTED / RECOVERED) is incident-relative and is distinct from the joined station's live connectivity (ONLINE / OFFLINE). ## OpenAPI ````yaml /api/specs/incident-management-api.json get /incident-management/v1/incidents/{id}/affected-stations openapi: 3.0.0 info: title: Lynkwell API version: 1.377.0 description: API Documentation for the Incident Management Service servers: - url: https://api.lynkwell.com security: [] tags: [] paths: /incident-management/v1/incidents/{id}/affected-stations: get: tags: - Incidents summary: List an incident's affected stations (roster) description: >- The incident's roster, keyset-paginated, with live station data joined in. Each row's status (AFFECTED / RECOVERED) is incident-relative and is distinct from the joined station's live connectivity (ONLINE / OFFLINE). parameters: - in: path name: id required: true schema: type: string - in: query name: status description: Filter to roster rows in this state. schema: type: string enum: - AFFECTED - RECOVERED - in: query name: limit schema: type: string pattern: ^[1-9][0-9]?$|^100$ - in: query name: startingAfter schema: type: string - in: query name: networkId schema: type: string responses: '200': description: A page of roster rows. content: application/json: schema: type: object properties: data: type: object properties: items: type: array items: $ref: '#/components/schemas/IncidentAffectedStation' hasMore: type: boolean required: - items - hasMore '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/IncidentBadRequestError' '401': description: Missing or invalid token content: application/json: schema: $ref: '#/components/schemas/IncidentUnauthorizedError' '403': description: Insufficient scope. The body is a plain-text message, not JSON. content: text/plain: schema: type: string '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/IncidentInternalServerError' security: - oauth2: - read:incident components: schemas: IncidentAffectedStation: type: object description: >- One row of an incident roster. The row status is incident-relative (AFFECTED / RECOVERED) and is distinct from the station's live connectivity, carried on the joined station object. properties: id: type: string networkId: type: string incidentId: type: string stationId: type: string status: type: string description: >- This station's state within the incident. AFFECTED while it is part of the open condition; RECOVERED once the condition has cleared for it. Not the same as being online. enum: - AFFECTED - RECOVERED detectedAt: type: string format: date-time description: This station's own detection time. recoveredAt: type: string format: date-time stationSnapshot: $ref: '#/components/schemas/IncidentStationSnapshot' mergedFromIncidentId: type: string description: >- The incident this station's row came from, when a merge folded it in. Absent on the stations that opened this incident. Only rows carrying it can be split back out. createdAt: type: string format: date-time updatedAt: type: string format: date-time station: type: object description: >- Live station data joined from the station mirror, when the station is known. properties: id: type: string name: type: string chargepointId: type: string serialNumber: type: string firmwareVersion: type: string connectivity: type: string description: >- The station's live reachability right now. Independent of the roster status: a station can read ONLINE while its incident is still open, and OFFLINE without a roster row during the detection window. enum: - ONLINE - OFFLINE required: - id - networkId - incidentId - stationId - status - detectedAt - createdAt - updatedAt IncidentBadRequestError: type: object description: The response body for a 400 request. properties: type: type: string enum: - BAD_REQUEST code: type: string description: >- A stable machine-readable error code identifying the specific validation failure. message: type: string required: - type - code - message IncidentUnauthorizedError: type: object description: The response body for a 401 request (missing or invalid token). properties: message: type: string required: - message IncidentInternalServerError: type: object description: The response body for a 500 request. properties: type: type: string enum: - INTERNAL_ERROR message: type: string required: - type - message IncidentStationSnapshot: type: object description: The station's identifiers as captured when it joined the roster. properties: capturedAt: type: string format: date-time serialNumber: type: string firmwareVersion: type: string required: - capturedAt securitySchemes: oauth2: type: oauth2 description: OAuth2 Client Credentials Flow flows: clientCredentials: tokenUrl: https://lynkwell-prod.us.auth0.com/oauth/token scopes: read:asset: Retrieve assets write:asset: Create and update assets read:assetgroup: Retrieve asset groups write:assetgroup: Create and update asset groups read:assetstatus: Retrieve asset statuses read:chargingstationmodel: Retrieve charging station models write:chargingstationmodel: Create and update charging station models write:network: Create and update networks write:sitepartner: Create and update site partners read:sitepartner: Retrieve site partners write:sitepartneruser: Create and update site partner users read:sitepartneruser: Retrieve site partner users read:networkaccessprofile: Retrieve network access profiles write:paymentprofile: Create payment profile write:onboardinglink: Create an onboarding link read:invoice: Retrieve an invoice write:session: Create or update a session read:session: Retrieve a session write:ticket: Create a ticket write:verificationcode: Send and confirm verification codes write:driver: Create and update drivers read:driver: Retrieve drivers write:token: Create and update tokens read:token: Retrieve tokens read:tokenvalue: Retrieve token by ID including its value write:invitecode: Create and update invite codes write:invitation: Create and update invitations read:invitation: Retrieve invitations read:payment_terminals_payment: Read payments from payment terminal abort:session: Abruptly end session read:paymentprofile: Retrieve payment profile from payment terminal write:ocpp: Sends request over OCPP write:ocpp.raw_request: Sends raw request over OCPP write:notification.email: Create and update email read:invoiceitem: Retrieve invoice item read:subscription: Retrieve subscription write:plugandcharge_enrollment: Update Plug and Charge enrollment status write:projects: Create and update projects read:projects: Retrieve projects write:project_stations: Create and update project stations write:panel: Create and update panels. read:panel: Retrieve panels. write:webhooks: Create, update, and delete webhooks read:webhooks: Retrieve webhooks read:incident: Retrieve incidents and their sub-resources write:incident: Create, update, comment on, merge, split, and link incidents ````