Introduction

Welcome to the documentation for the Pulse API. Here you will be able to find all of our available resources and how to use them. To use our API, all endpoints require a token that can be created when you login to Pulse.

This documentation aims to provide all the information you need to work with our API.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can generate API tokens within Pulse when logged in. Click on your name in the bottom left, then click API Tokens, give your token a name and then click Save. Your token will only be shown that one time, so make sure to copy it there and then. Tokens can be revoked at any time.

Company

Show

GET
https://pulsereviews.io
/api/company
requires authentication

This endpoint will show details of the company that the api token is for.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json
Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/company';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
{
    "data": {
        "name": "Holmes Ltd",
        "locations": []
    }
}
{
    "message": "Unauthenticated"
}
{
    "message": "This action is unauthorized."
}

Google Locations

Endpoints for managing Google locations on Pulse

List

GET
https://pulsereviews.io
/api/locations/google
requires authentication

This endpoint will list all Google locations tied to the user.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json
Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/locations/google';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
{
    "data": [
        {
            "id": "93598351",
            "name": "Evans Ltd",
            "googleRating": 3.2,
            "preciseGoogleRating": 3.2043,
            "reviewsCount": 193,
            "site": "mason.com",
            "address": "213 Harley Union\nNew Samuelfort\nSP1 1NE",
            "regularHours": {
                "MONDAY": {
                    "open": "8:00",
                    "close": "17:00"
                },
                "TUESDAY": {
                    "open": "8:00",
                    "close": "17:00"
                },
                "WEDNESDAY": {
                    "open": "8:00",
                    "close": "21:00"
                },
                "THURSDAY": {
                    "open": "8:00",
                    "close": "21:00"
                },
                "FRIDAY": {
                    "open": "8:00",
                    "close": "21:00"
                },
                "SATURDAY": {
                    "open": "8:00",
                    "close": "17:00"
                },
                "SUNDAY": {
                    "open": "10:00",
                    "close": "16:00"
                }
            },
            "specialHours": {
                "2024-12-25": {
                    "status": "closed",
                    "open": null,
                    "close": null
                },
                "2024-12-24": {
                    "status": "open",
                    "open": "10:00",
                    "close": "15:00"
                }
            }
        },
        {
            "id": "50830334",
            "name": "Roberts Ltd",
            "googleRating": 4,
            "preciseGoogleRating": 4.0328,
            "reviewsCount": 64,
            "site": "mitchell.com",
            "address": "5 Elizabeth Grove\nMaxfurt\nLS16 8EE",
            "regularHours": {
                "MONDAY": {
                    "open": "8:00",
                    "close": "17:00"
                },
                "TUESDAY": {
                    "open": "8:00",
                    "close": "17:00"
                },
                "WEDNESDAY": {
                    "open": "8:00",
                    "close": "21:00"
                },
                "THURSDAY": {
                    "open": "8:00",
                    "close": "21:00"
                },
                "FRIDAY": {
                    "open": "8:00",
                    "close": "21:00"
                },
                "SATURDAY": {
                    "open": "8:00",
                    "close": "17:00"
                },
                "SUNDAY": {
                    "open": "10:00",
                    "close": "16:00"
                }
            },
            "specialHours": {
                "2024-12-25": {
                    "status": "closed",
                    "open": null,
                    "close": null
                },
                "2024-12-24": {
                    "status": "open",
                    "open": "10:00",
                    "close": "15:00"
                }
            }
        }
    ],
    "links": {
        "first": "/?page=1",
        "last": "/?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "Previous",
                "page": null,
                "active": false
            },
            {
                "url": "/?page=1",
                "label": "1",
                "page": 1,
                "active": true
            },
            {
                "url": null,
                "label": "Next",
                "page": null,
                "active": false
            }
        ],
        "path": "/",
        "per_page": 15,
        "to": 2,
        "total": 2
    }
}
{
    "message": "Unauthenticated"
}

Show

GET
https://pulsereviews.io
/api/locations/google/{googleLocation_google_id}
requires authentication

This endpoint will show a specific Google location, based on Google ID.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

googleLocation_google_id
The Google ID of the Location you want to show.
required
Example:
749845872867289688
Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/locations/google/749845872867289688';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
{
    "data": {
        "id": "90888257",
        "name": "Mason Ltd",
        "googleRating": 3.6,
        "preciseGoogleRating": 3.5759,
        "reviewsCount": 57,
        "site": "graham.co.uk",
        "address": "7 Quentin Glen\nEleanorton\nS70 5RT",
        "regularHours": {
            "MONDAY": {
                "open": "8:00",
                "close": "17:00"
            },
            "TUESDAY": {
                "open": "8:00",
                "close": "17:00"
            },
            "WEDNESDAY": {
                "open": "8:00",
                "close": "21:00"
            },
            "THURSDAY": {
                "open": "8:00",
                "close": "21:00"
            },
            "FRIDAY": {
                "open": "8:00",
                "close": "21:00"
            },
            "SATURDAY": {
                "open": "8:00",
                "close": "17:00"
            },
            "SUNDAY": {
                "open": "10:00",
                "close": "16:00"
            }
        },
        "specialHours": {
            "2024-12-25": {
                "status": "closed",
                "open": null,
                "close": null
            },
            "2024-12-24": {
                "status": "open",
                "open": "10:00",
                "close": "15:00"
            }
        }
    }
}
{
    "message": "Unauthenticated"
}
{
    "message": "This action is unauthorized."
}

Update

PATCH
https://pulsereviews.io
/api/locations/google/{googleLocation_google_id}
requires authentication

This endpoint can be used to update a Google location. Currently, the Pulse API can only be used to update Regular and Special hours. This endpoint is subject to Google rate limits so make sure you allow for plenty of time for the update to complete.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

googleLocation_google_id
The Google ID of the Location you want to update.
required
Example:
749845872867289688

Body Parameters

Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/locations/google/749845872867289688';
$response = $client->patch(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'applyChangesOn' => '2030-05-01 23:00:00',
            'notes' => 'Changes Wednesday to open at 10am and close at 4pm.',
            'validateOnly' => true,
            'regularHours' => [
                [
                    'day' => 'Thursday',
                    'openTime' => '2018-05-03',
                    'closeTime' => '00:37',
                ],
                'openTime' => '09:00',
                'closeTime' => '17:00',
                'day' => 'Monday',
            ],
            'specialHours' => [
                [
                    'date' => '2026-03-21',
                    'openTime' => '1996-04-22',
                    'closeTime' => '00:37',
                ],
                'date' => '2024-12-24',
                'openTime' => '09:00',
                'closeTime' => '17:00',
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
{
    "data": {
        "id": null,
        "payload": {
            "title": "Palmer Ltd",
            "profile": {
                "description": "Non hic tempore deleniti asperiores quos quisquam. Alias totam assumenda vitae dicta minima. Pariatur beatae est eaque illo quos iure quasi."
            },
            "phoneNumbers": {
                "primaryPhone": "0833 686 6655",
                "addititionalPhones": []
            },
            "websiteUrl": "adams.com",
            "storefrontAddress": {
                "postalCode": "DD8 4EX",
                "locality": "Christopherborough",
                "addressLines": [
                    "Studio 14r\nTheo Meadows",
                    "",
                    "",
                    "",
                    ""
                ],
                "regionCode": "GB"
            },
            "regularHours": {
                "periods": [
                    {
                        "openDay": "MONDAY",
                        "closeDay": "MONDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "TUESDAY",
                        "closeDay": "TUESDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "WEDNESDAY",
                        "closeDay": "WEDNESDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "THURSDAY",
                        "closeDay": "THURSDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "FRIDAY",
                        "closeDay": "FRIDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    }
                ]
            },
            "specialHours": {
                "specialHourPeriods": [
                    {
                        "closed": true,
                        "endDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 25
                        },
                        "openTime": {
                            "hours": null,
                            "minutes": null
                        },
                        "closeTime": {
                            "hours": null,
                            "minutes": null
                        },
                        "startDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 25
                        }
                    },
                    {
                        "closed": false,
                        "endDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 24
                        },
                        "openTime": {
                            "hours": 10,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 15,
                            "minutes": 0
                        },
                        "startDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 24
                        }
                    }
                ]
            }
        },
        "process_at": "2026-04-02T00:37:25.000000Z",
        "notes": "Rem veniam excepturi veniam hic voluptas. Repellat et laboriosam beatae quasi. Optio illo eum odio quas.",
        "validateOnly": true
    }
}
{
    "message": "Unauthenticated"
}
{
    "message": "This action is unauthorized."
}

Copy Hours

POST
https://pulsereviews.io
/api/locations/google/{googleLocation_google_id}/copy-hours
requires authentication

Copy this location's regular and/or special opening hours to other locations in your company. Creates one pending update per target location; changes are applied according to each update's process_at.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

googleLocation_google_id
The Google ID of the source location to copy hours from.
required
Example:
749845872867289688

Body Parameters

Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/locations/google/749845872867289688/copy-hours';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'target_google_ids' => [
                749845872867289689,
                749845872867289690,
            ],
            'hours_to_copy' => [
                'regularHours',
                'specialHours',
            ],
            'apply_changes_on' => '2030-05-01 23:00:00',
            'notes' => 'nobis',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
{
    "data": [
        {
            "id": null,
            "payload": {
                "title": "Chapman Ltd",
                "profile": {
                    "description": "Expedita eum nulla voluptate consequatur voluptatem est accusantium. Ducimus eaque similique voluptatem veniam vero est quas. Fuga facilis quis et vel non."
                },
                "phoneNumbers": {
                    "primaryPhone": "0478 869 4568",
                    "addititionalPhones": []
                },
                "websiteUrl": "evans.net",
                "storefrontAddress": {
                    "postalCode": "HA7 1HB",
                    "locality": "Patrickport",
                    "addressLines": [
                        "12 Turner Overpass",
                        "",
                        "",
                        "",
                        ""
                    ],
                    "regionCode": "GB"
                },
                "regularHours": {
                    "periods": [
                        {
                            "openDay": "MONDAY",
                            "closeDay": "MONDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        },
                        {
                            "openDay": "TUESDAY",
                            "closeDay": "TUESDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        },
                        {
                            "openDay": "WEDNESDAY",
                            "closeDay": "WEDNESDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        },
                        {
                            "openDay": "THURSDAY",
                            "closeDay": "THURSDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        },
                        {
                            "openDay": "FRIDAY",
                            "closeDay": "FRIDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        }
                    ]
                },
                "specialHours": {
                    "specialHourPeriods": [
                        {
                            "closed": true,
                            "endDate": {
                                "year": 2024,
                                "month": 12,
                                "day": 25
                            },
                            "openTime": {
                                "hours": null,
                                "minutes": null
                            },
                            "closeTime": {
                                "hours": null,
                                "minutes": null
                            },
                            "startDate": {
                                "year": 2024,
                                "month": 12,
                                "day": 25
                            }
                        },
                        {
                            "closed": false,
                            "endDate": {
                                "year": 2024,
                                "month": 12,
                                "day": 24
                            },
                            "openTime": {
                                "hours": 10,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 15,
                                "minutes": 0
                            },
                            "startDate": {
                                "year": 2024,
                                "month": 12,
                                "day": 24
                            }
                        }
                    ]
                }
            },
            "process_at": "2026-03-27T00:37:25.000000Z",
            "notes": "Dicta asperiores earum placeat tenetur iste voluptas dicta deleniti. Rerum voluptas iure voluptas officia. Dolorum soluta molestiae reiciendis sed maiores provident.",
            "validateOnly": true
        },
        {
            "id": null,
            "payload": {
                "title": "Hunter Ltd",
                "profile": {
                    "description": "Sint quis magnam officiis alias. Error expedita voluptatem et eum. Hic in provident vel architecto alias accusamus placeat."
                },
                "phoneNumbers": {
                    "primaryPhone": "+44(0)1104 794134",
                    "addititionalPhones": []
                },
                "websiteUrl": "smith.com",
                "storefrontAddress": {
                    "postalCode": "RG27 8PG",
                    "locality": "Port Jamiemouth",
                    "addressLines": [
                        "5 Ray Field",
                        "",
                        "",
                        "",
                        ""
                    ],
                    "regionCode": "GB"
                },
                "regularHours": {
                    "periods": [
                        {
                            "openDay": "MONDAY",
                            "closeDay": "MONDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        },
                        {
                            "openDay": "TUESDAY",
                            "closeDay": "TUESDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        },
                        {
                            "openDay": "WEDNESDAY",
                            "closeDay": "WEDNESDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        },
                        {
                            "openDay": "THURSDAY",
                            "closeDay": "THURSDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        },
                        {
                            "openDay": "FRIDAY",
                            "closeDay": "FRIDAY",
                            "openTime": {
                                "hours": 8,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 18,
                                "minutes": 0
                            }
                        }
                    ]
                },
                "specialHours": {
                    "specialHourPeriods": [
                        {
                            "closed": true,
                            "endDate": {
                                "year": 2024,
                                "month": 12,
                                "day": 25
                            },
                            "openTime": {
                                "hours": null,
                                "minutes": null
                            },
                            "closeTime": {
                                "hours": null,
                                "minutes": null
                            },
                            "startDate": {
                                "year": 2024,
                                "month": 12,
                                "day": 25
                            }
                        },
                        {
                            "closed": false,
                            "endDate": {
                                "year": 2024,
                                "month": 12,
                                "day": 24
                            },
                            "openTime": {
                                "hours": 10,
                                "minutes": 0
                            },
                            "closeTime": {
                                "hours": 15,
                                "minutes": 0
                            },
                            "startDate": {
                                "year": 2024,
                                "month": 12,
                                "day": 24
                            }
                        }
                    ]
                }
            },
            "process_at": "2026-04-15T00:37:25.000000Z",
            "notes": "Est possimus et et tenetur ut alias. Provident laboriosam in et natus et repudiandae. Id dolorum voluptas quibusdam accusamus saepe.",
            "validateOnly": false
        }
    ]
}
{
    "message": "Unauthenticated"
}
{
    "message": "This action is unauthorized."
}
{
    "message": "All target locations must belong to your company and not be the source location."
}
{
    "message": "Please select at least one of Regular hours or Special hours."
}

List Updates

GET
https://pulsereviews.io
/api/locations/google/{googleLocation_google_id}/updates
requires authentication

This endpoint will list all updates for the specified Google location.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

googleLocation_google_id
The Google ID of the location you want to list updates for
required
Example:
749845872867289688
Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/locations/google/749845872867289688/updates';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
{
    "data": {
        "id": null,
        "payload": {
            "title": "Williams Ltd",
            "profile": {
                "description": "Sunt eaque esse non soluta autem saepe dolorem. Eveniet porro id est quam voluptatibus distinctio distinctio eveniet. Est consectetur quos vel eligendi quod."
            },
            "phoneNumbers": {
                "primaryPhone": "07604 413680",
                "addititionalPhones": []
            },
            "websiteUrl": "wilson.com",
            "storefrontAddress": {
                "postalCode": "NG17 4JY",
                "locality": "East Robhaven",
                "addressLines": [
                    "90 Jordan Trail",
                    "",
                    "",
                    "",
                    ""
                ],
                "regionCode": "GB"
            },
            "regularHours": {
                "periods": [
                    {
                        "openDay": "MONDAY",
                        "closeDay": "MONDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "TUESDAY",
                        "closeDay": "TUESDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "WEDNESDAY",
                        "closeDay": "WEDNESDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "THURSDAY",
                        "closeDay": "THURSDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "FRIDAY",
                        "closeDay": "FRIDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    }
                ]
            },
            "specialHours": {
                "specialHourPeriods": [
                    {
                        "closed": true,
                        "endDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 25
                        },
                        "openTime": {
                            "hours": null,
                            "minutes": null
                        },
                        "closeTime": {
                            "hours": null,
                            "minutes": null
                        },
                        "startDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 25
                        }
                    },
                    {
                        "closed": false,
                        "endDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 24
                        },
                        "openTime": {
                            "hours": 10,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 15,
                            "minutes": 0
                        },
                        "startDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 24
                        }
                    }
                ]
            }
        },
        "process_at": "2026-03-28T00:37:25.000000Z",
        "notes": "Reiciendis debitis est sed eos iure dolores ut. Aliquid at libero in enim. Id enim nulla alias asperiores minima.",
        "validateOnly": false
    }
}
{
    "message": "Unauthenticated"
}

Show Update

GET
https://pulsereviews.io
/api/locations/google/{googleLocation_google_id}/updates/{pendingGoogleLocationUpdate_id}
requires authentication

This endpoint will show a specific update for the specified Google location.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

googleLocation_google_id
The Google ID of the location attached to the update you want to show.
required
Example:
749845872867289688
pendingGoogleLocationUpdate_id
The ID of the update you want to show.
required
Example:
23
Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/locations/google/749845872867289688/updates/23';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
{
    "data": {
        "id": null,
        "payload": {
            "title": "Clark Ltd",
            "profile": {
                "description": "Velit perferendis ipsam eius laudantium vel sapiente. Est expedita et aliquam numquam temporibus laboriosam. Magnam voluptates veritatis ut doloremque."
            },
            "phoneNumbers": {
                "primaryPhone": "0125497703",
                "addititionalPhones": []
            },
            "websiteUrl": "saunders.com",
            "storefrontAddress": {
                "postalCode": "FK3 8EP",
                "locality": "East Kellymouth",
                "addressLines": [
                    "Studio 98u\nAnna Fork",
                    "",
                    "",
                    "",
                    ""
                ],
                "regionCode": "GB"
            },
            "regularHours": {
                "periods": [
                    {
                        "openDay": "MONDAY",
                        "closeDay": "MONDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "TUESDAY",
                        "closeDay": "TUESDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "WEDNESDAY",
                        "closeDay": "WEDNESDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "THURSDAY",
                        "closeDay": "THURSDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    },
                    {
                        "openDay": "FRIDAY",
                        "closeDay": "FRIDAY",
                        "openTime": {
                            "hours": 8,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 18,
                            "minutes": 0
                        }
                    }
                ]
            },
            "specialHours": {
                "specialHourPeriods": [
                    {
                        "closed": true,
                        "endDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 25
                        },
                        "openTime": {
                            "hours": null,
                            "minutes": null
                        },
                        "closeTime": {
                            "hours": null,
                            "minutes": null
                        },
                        "startDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 25
                        }
                    },
                    {
                        "closed": false,
                        "endDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 24
                        },
                        "openTime": {
                            "hours": 10,
                            "minutes": 0
                        },
                        "closeTime": {
                            "hours": 15,
                            "minutes": 0
                        },
                        "startDate": {
                            "year": 2024,
                            "month": 12,
                            "day": 24
                        }
                    }
                ]
            }
        },
        "process_at": "2026-03-30T00:37:25.000000Z",
        "notes": "Suscipit reiciendis ullam incidunt non ab cumque. Quia amet assumenda quis quidem eum officiis. Quas rem dolorum nemo sapiente eveniet.",
        "validateOnly": true
    }
}
{
    "message": "Unauthenticated"
}

Delete Update

DELETE
https://pulsereviews.io
/api/locations/google/{googleLocation_google_id}/updates/{pendingGoogleLocationUpdate_id}
requires authentication

This endpoint will delete a specific update for the specified Google location.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

googleLocation_google_id
The Google ID for the location attached to the update you want to delete.
required
Example:
749845872867289688
pendingGoogleLocationUpdate_id
The ID of the update you want to delete.
required
Example:
23
Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/locations/google/749845872867289688/updates/23';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
[Empty response]
{
    "message": "Unauthenticated"
}

Health

Check

GET
https://pulsereviews.io
/api/health
requires authentication

This endpoint will allow you to quickly check that you can authenticate to the API.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json
Example request:
$client = new \GuzzleHttp\Client();
$url = 'https://pulsereviews.io/api/health';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
Example response:
{
    "status": "ok"
}
{
    "message": "Unauthenticated"
}