v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB

Google

Start Google Location Verification Process

This endpoint initiates the verification process for a specific Google location identified by google_location_id. It requires authentication and authorization to access. The user must have at least the role of a BUSINESS_MANAGER to use this endpoint.

The endpoint ensures that the chosen verification method has all the necessary information for the specific method chosen. If any required information is missing, it raises an error with the associated error message.

post/verifications/google-locations/{google_location_id}/start

Path parameters

google_location_idstring required

Google location unique id on Partoo

Request body

method'SMS' | 'PHONE_CALL' | 'EMAIL' | 'ADDRESS'

phone_numberstring

REQUIRED for SMS and PHONE_CALL methods. The phone number to which the code will be send.

emailstring

REQUIRED for EMAIL method. The email address to which the code will be send.

full_namestring

REQUIRED for ADDRESS method. The full name to which the postcard will be send.

Example request

{
  "phone_number": "+33187662490",
  "email": "email.api@partoo.fr",
  "full_name": "John Doe"
}

Response

statusstring

The status of the response success or error.

message'start_no_verification_found' | 'start_error'

OPTIONAL Details of the error encountered. Can be one of the following:

start_no_verification_found: No verification request has been started.
start_error: An error occured during the start of the verification process.

Example response

{
  "status": "success"
}