Check Match Pro Connection

curl --request GET \
  --url https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "statusConnection": {
      "status": "CONNECTED",
      "message": "Connection established successfully",
      "details": {
        "isActive": true,
        "expiresAt": "2027-01-01T00:00:00.000Z",
        "certificateExpiry": "2027-01-01T00:00:00.000Z"
      }
    }
  }
}

Match Pro

Check Match Pro Connection

Tests whether the stored Match Pro credentials are valid and reachable. Use this endpoint after saving credentials to confirm the setup is working before running match checks.

Status values:

CONNECTED — credentials are valid and the connection is active
NOT_CONNECTED — no credentials saved, or isActive is false
EXPIRED — the key file certificate has passed its expiry date
ERROR — credentials exist but the connection attempt failed

The customerId path parameter must belong to the caller’s tenant. Cross-tenant access is rejected with 403.

GET

match-pro

{customerId}

check-connection-status

Check Match Pro Connection

curl --request GET \
  --url https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.joinworth.com/integration/api/v1/match-pro/{customerId}/check-connection-status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "statusConnection": {
      "status": "CONNECTED",
      "message": "Connection established successfully",
      "details": {
        "isActive": true,
        "expiresAt": "2027-01-01T00:00:00.000Z",
        "certificateExpiry": "2027-01-01T00:00:00.000Z"
      }
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customerId

string

required

UUID of the customer tenant. Must belong to the authenticated caller's tenant.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Query Parameters

acquirerId

string

Optional. Test connectivity for a specific acquirer ID instead of the default stored value.

Example:

"123456"

Response

Connection status retrieved successfully.

status

enum<string>

Available options:

success

data

object

Show child attributes

⌘I

Sign In

Forgot Password

Customers

Customer Users

Business

Cases

Business Details

Worth 360 Report

NPI

Custom Fields

Match Pro

Check Match Pro Connection

Authorizations

Path Parameters

Query Parameters

Response