GET
/
api
/
ftpos
/
business
/
{merchant_id}
Look Up Business UUID
curl --request GET \
  --url https://monitoring.safeturf.ai/api/ftpos/business/{merchant_id} \
  --header 'Authorization: Bearer <token>'
{
  "business_uuid": "<string>",
  "business_name": "<string>",
  "merchant_id": 123
}

​
Overview

After submitting a dealer via Dealer Import, the import runs asynchronously in the background. Use this endpoint to poll until the business record is available and retrieve the business_uuid needed for subsequent API calls. Typical partner flow:
  1. POST /api/ftpos/import-generic → receive merchant_id
  2. GET /api/ftpos/business/{merchant_id} → poll until 200, collect business_uuid
  3. GET /api/underwriting/case/{business_uuid} → check underwriting status

​
Authentication

Every request must include a Bearer token in the Authorization header: 
Authorization: Bearer <your_api_token>

​
Path Parameters

​
merchant_id
integer
required
Your numeric merchant ID — the same value you passed as merchantId in the import request.

​
Example Request

curl -X GET "https://api.safeturf.com/api/ftpos/business/98001" \
  -H "Authorization: Bearer <your_api_token>"

​
Response

{
  "business_uuid": "b3f1c2a4-91de-4e7c-a823-5f6d84c2e001",
  "business_name": "Acme Solar LLC",
  "merchant_id": 98001
}
​
business_uuid
string
Safeturf’s unique identifier for this business. Use this with the Check UW Status and Trigger Verification endpoints.
​
business_name
string
Legal name of the business as stored in Safeturf.
​
merchant_id
integer
Echo of the merchant ID from the path parameter.

​
Error Responses

StatusMeaning
401Missing or invalid Bearer token
404Business not found — the import flow may still be running. Retry in a few seconds.
500Internal error — contact Safeturf support

​
Notes

  • 404 means “not yet” — the import workflow is asynchronous and typically completes within 10–30 seconds. Poll with a short delay (e.g. every 5 seconds) until you receive a 200.
  • Once you have the business_uuid, use Check UW Status to monitor verification progress.