GET
/
v1
/
address
/
session
/
status
curl --request GET \
  --url https://api.findloka.com/v1/address/session/status \
  --header 'Authorization: <authorization>'
{
  "status": "PROCESSING",
  "progress": {
    "total": 100,
    "processed": 75,
    "successful": 70,
    "failed": 5
  }
}

​
Overview

The Check Session Status API allows you to monitor the progress of a previously initiated address import session. This endpoint is useful for tracking long-running import operations and determining when they’ve completed.

To obtain an API key, please contact our sales team.

​
Authorization

​
Authorization
string
required

Your API key for authentication

​
Query Parameters

​
session_id
string
required

The unique identifier of the import session to check

{
  "status": "PROCESSING",
  "progress": {
    "total": 100,
    "processed": 75,
    "successful": 70,
    "failed": 5
  }
}

​
Notes

  • The response includes two main components:
    • status: Current state of the session (“PROCESSING”, “COMPLETED”, “FAILED”, etc.)
    • progress: Detailed metrics about the import operation
      • total: Total number of addresses in the import batch
      • processed: Number of addresses that have been processed so far
      • successful: Number of addresses successfully imported
      • failed: Number of addresses that failed to import
  • A response with “Session not found” status and -1 progress values indicates that the session doesn’t exist
  • You should poll this endpoint periodically until status changes to “COMPLETED” or all addresses have been processed (processed equals total)
  • Once processing is complete, the sum of successful and failed will equal total