Scans

Get user scans

get

Get all scans for the authenticated user with pagination and sorting

Authorizations

AuthorizationstringRequired

Session token in Bearer format: Bearer

Query parameters

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 10

sortstring · enumOptional

Sort order by timestamp

Default: descPossible values:

Responses

200

User scans retrieved successfully

application/json

401

Unauthorized - invalid or missing session token

application/json

500

Internal server error

application/json

get/user/scans

GET /api/v1/user/scans HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "scans": [
    {
      "id": "text",
      "lat": 1,
      "long": 1,
      "scanUrl": "text",
      "timestamp": "2026-01-01T00:00:00.000Z",
      "status": "text",
      "title": "text",
      "category": "text",
      "location": "text",
      "fileType": "text",
      "previewImageUrl": "text",
      "timeOfDay": "text",
      "weather": "text"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "totalPages": 1
  }
}

Get public scans

get

Get all public scans with pagination

Authorizations

x-app-api-keystringRequired

App API key in format:

Query parameters

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 10

Responses

200

Public scans retrieved successfully

application/json

401

Unauthorized - invalid or missing session token

application/json

500

Internal server error

application/json

get/scans/public-scans

GET /api/v1/scans/public-scans HTTP/1.1
x-app-api-key: YOUR_API_KEY
Accept: */*

{
  "scans": [
    {
      "id": "text",
      "lat": 1,
      "long": 1,
      "scanUrl": "text",
      "timestamp": "2026-01-01T00:00:00.000Z",
      "status": "text",
      "title": "text",
      "category": "text",
      "location": "text",
      "fileType": "text",
      "previewImageUrl": "text",
      "timeOfDay": "text",
      "weather": "text"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "totalPages": 1
  }
}