POST
/
v1
/
session
/
import-addresses
Session Import Addresses
curl --request POST \
  --url https://api.findloka.com/v1/session/import-addresses \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "session_id": "<string>",
  "addresses": [
    "<string>"
  ]
}'
{
  "import_status": [
    {
      "address": "123 Main St, San Francisco, CA 94105",
      "imported": true,
      "status": "Imported"
    },
    {
      "address": "456 Market St, San Francisco, CA 94105",
      "imported": false,
      "status": "Already exists"
    },
    {
      "address": "Invalid Address",
      "imported": false,
      "status": "Invalid address"
    }
  ],
  "batch_id": "1a2b3c4d5e6f7g8h9i0j",
  "checked_addresses_total": 3,
  "imported_addresses_count": 1,
  "already_exists_addresses_count": 1,
  "invalid_addresses_count": 1
}

​
Overview

The Session Import Addresses API allows you to submit a batch of addresses to be processed and stored in our database within a specific session context. This endpoint is designed for bulk address importing as part of a multi-batch import workflow.

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

​
Authorization

​
Authorization
string
required

Your API key for authentication

​
Body

​
session_id
string
required

The session ID obtained from the Create Import Session endpoint

​
addresses
string[]
required

Array of addresses to import and process

{
  "import_status": [
    {
      "address": "123 Main St, San Francisco, CA 94105",
      "imported": true,
      "status": "Imported"
    },
    {
      "address": "456 Market St, San Francisco, CA 94105",
      "imported": false,
      "status": "Already exists"
    },
    {
      "address": "Invalid Address",
      "imported": false,
      "status": "Invalid address"
    }
  ],
  "batch_id": "1a2b3c4d5e6f7g8h9i0j",
  "checked_addresses_total": 3,
  "imported_addresses_count": 1,
  "already_exists_addresses_count": 1,
  "invalid_addresses_count": 1
}

​
Notes

  • This endpoint must be used with a valid session ID created using the Create Import Session endpoint
  • Each address in the response includes:
    • The original address string
    • An imported flag indicating whether the address was successfully processed
    • A status field with detailed information about what happened with the address
  • Possible status values include:
    • “Imported”: Address was successfully validated and added to the database
    • “Already exists”: Address already exists in the database
    • “Invalid address”: Address could not be validated or standardized
  • The response includes summary counts for each type of result
  • If none of the addresses could be imported, batch_id will be null
  • Use the Check Batch Status endpoint to monitor the processing status of imported addresses
  • There is a limit to how many addresses can be imported in a single request