Skip to main content
GET
/
anomalies
/
v2
/
rs
/
{anomalyId}
cURL
curl --request GET \
  --url https://z52mnqg347.execute-api.eu-west-3.amazonaws.com/main/anomalies/v2/rs/{anomalyId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --header 'X-Session-Token: <x-session-token>'
{
  "data": {
    "id": 1,
    "ref": "E42-RI12-3",
    "status": 1,
    "title": "Anomaly title",
    "description": "Anomaly description",
    "type": 1,
    "risk": 1,
    "dueAt": "2024-12-01T12:34:56.000Z",
    "observedAt": "2024-12-01T12:34:56.000Z",
    "deletedAt": "2024-01-15T08:45:00.000Z",
    "updatedAt": "2024-12-05T14:56:23.000Z",
    "createdAt": "2024-01-15T08:45:00.000Z",
    "onSiteObs": true,
    "technicalInstallation": {
      "id": 1,
      "name": "establishment_informations.installation_ascenseurs",
      "isInSafetyRegister": false,
      "isDefault": false,
      "deletedAt": "2024-03-12T16:30:00.000Z"
    },
    "site": {
      "id": 1,
      "name": "Main site",
      "isEstablishment": true,
      "serialNumber": "123456",
      "mainEstablishment": {
        "id": 1,
        "name": "Main site"
      }
    },
    "resolvedBy": {
      "id": 1,
      "firstName": "John",
      "lastName": "Doe",
      "roles": [
        1,
        2
      ],
      "permissionGroup": 123
    },
    "actions": {
      "canBeUpdated": true,
      "canBeDeleted": true,
      "canBeRestored": true,
      "canBeResolved": true,
      "canBeUnresolved": true,
      "canBePositioned": true
    },
    "origin": {
      "reportedBy": {
        "id": 1,
        "firstName": "John",
        "lastName": "Doe"
      },
      "commission": {
        "id": 1,
        "visitType": 1,
        "commissionType": 1,
        "decision": 1,
        "date": "2024-12-01T12:34:56.000Z",
        "report": {
          "id": 1,
          "status": 1,
          "checkDate": "2024-12-01T12:34:56.000Z",
          "name": "Document Name",
          "presignedUrl": "<string>"
        }
      },
      "intervention": {
        "id": 1,
        "startDate": "2024-12-01T12:34:56.000Z",
        "endDate": "2024-12-01T12:34:56.000Z",
        "provider": {
          "providerName": "Provider name",
          "providerEmail": "[email protected]"
        },
        "companyContact": {
          "id": 1,
          "name": "Company Contact Name",
          "email": "[email protected]"
        },
        "checkType": 1,
        "company": {
          "id": 1,
          "name": "Company Name",
          "type": 1
        },
        "report": {
          "id": 1,
          "status": 1,
          "checkDate": "2024-12-01T12:34:56.000Z",
          "name": "Document Name",
          "presignedUrl": "<string>"
        }
      },
      "report": {
        "id": 1,
        "status": 1,
        "checkDate": "2024-12-01T12:34:56.000Z",
        "name": "Document Name",
        "presignedUrl": "<string>"
      }
    },
    "images": [
      {
        "file": "image1",
        "size": 1024,
        "presignedUrl": "<string>"
      }
    ],
    "interventions": [
      {
        "id": 1,
        "isDone": true,
        "images": [
          "image1",
          "image2"
        ],
        "startDate": "2024-12-01T12:34:56.000Z",
        "endDate": "2024-12-01T12:34:56.000Z",
        "providerAction": 1,
        "providerComment": "Comment on the interventionAnomaly",
        "status": 2,
        "companyContact": {
          "id": 1,
          "name": "Company Contact Name",
          "email": "[email protected]"
        },
        "providerEmail": "[email protected]",
        "providerName": "Provider name",
        "companyName": "Company Name"
      }
    ],
    "equipment": {
      "id": 1,
      "name": "Equipment Name",
      "archivedAt": "2024-12-01T12:34:56.000Z"
    },
    "updatableFields": {
      "title": true,
      "description": true,
      "risk": true,
      "technicalInstallationId": [
        123
      ],
      "siteId": [
        123
      ],
      "location": true,
      "resolvedComment": true
    },
    "metadata": {
      "location": {
        "floor": "<string>",
        "room": "<string>"
      },
      "reporter": {
        "firstName": "<string>",
        "lastName": "<string>"
      },
      "resolvedComment": "<string>"
    },
    "comments": [
      {
        "id": 1,
        "profileId": 42,
        "comment": "This is a comment.",
        "anomalyId": 5,
        "updatedAt": "2025-05-06T12:00:00.000Z",
        "createdAt": "2025-05-01T09:30:00.000Z"
      }
    ],
    "position": {
      "id": 1,
      "xPercent": 1,
      "yPercent": 1
    },
    "plan": {
      "id": 1,
      "name": "Main Plan"
    },
    "building": {
      "id": 1,
      "name": "Main Building"
    },
    "isPositioned": true,
    "containedIn": [
      {
        "id": 1,
        "name": "Plan Item 1"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Session-Token
string
required

Session token used for authenticating the request.

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiIxMjM0NTY3ODkwIiwic2Vzc2lvbklkIjoiYWJjZGVmMTIzNDU2IiwiaWF0IjoxNjA1MDk3ODk5LCJleHAiOjE2MDUxODQyOTl9.4XRQ1iXDyvEj5LgPZHbmTmzOZs98M3YPOzgf3MhxjaI"

Content-Type
enum<string>
required

Content type, must be "application/json".

Available options:
application/json

Path Parameters

anomalyId
integer
required

Unique identifier of the anomaly.

Example:

1

Query Parameters

extend
enum<string>[]

Extend options:

  • "technical-installation": Get information about the technicalInstallation

  • "site": Get information about the site

  • "resolved-by": Get information about the person that resolved the anomaly

  • "actions-info": Give information about the origin of the anomaly (commission or intervention)

  • "origin": Provides anomaly origin information based on type: observation→reportedBy, prescription→commission, nonconformity→intervention

  • "anomaly-images": Give information about the images of the anomaly

  • "interventions": Get information about the interventions

  • "equipment": Get information about the equipment linked to the intervention

  • "updatable-fields": Get information about the field that can be updated

  • "metadata": Get complete metadata for the anomaly

  • "comments": Get comments for the anomaly

  • "position": Get information about the position related to the anomaly

Available options:
technical-installation,
site,
resolved-by,
actions-info,
origin,
anomaly-images,
interventions,
equipment,
updatable-fields,
metadata,
comments,
position

Response

200 - application/json

Get the anomaly information

data
object
required