Check Service Connection

GET

connect

check

curl --request GET \
  --url https://auth.nullpass.xyz/api/connect/check \
  --header 'Authorization: Bearer <token>'

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

fetch('https://auth.nullpass.xyz/api/connect/check', 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://auth.nullpass.xyz/api/connect/check",
  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://auth.nullpass.xyz/api/connect/check"

	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://auth.nullpass.xyz/api/connect/check")

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

{
  "connected": true,
  "tier": "<string>",
  "isPremium": true
}

Endpoint

GET /api/connect/check

Overview

Checks the connection status for a specific service. Returns whether the service is connected and entitlement details.

Request

Requires authentication via Bearer token.

Query Parameters

ServiceIdentifier

required

Service identifier: DROP, MAILS, VAULT, or DB

Response

boolean

Whether the service is connected

string

Service identifier

string

Access tier (if entitlement exists)

boolean

Premium access flag (if entitlement exists)

Implementation Details

Code Reference

export async function GET(request: NextRequest) {
  const corsResponse = handleCors(request)
  if (corsResponse) return corsResponse

  const blocked = await protectRoute(request)
  if (blocked) return blocked

  const auth = await requireAuth(request)
  if ('error' in auth) return auth.error

  try {
    const { searchParams } = new URL(request.url)
    const service = searchParams.get('service') as 'DROP' | 'MAILS' | 'VAULT' | 'DB' | null

    if (!service) {
      return errorResponse('Service parameter is required', 400, request.headers.get('origin'))
    }

    if (!['DROP', 'MAILS', 'VAULT', 'DB'].includes(service)) {
      return errorResponse('Invalid service. Must be DROP, MAILS, VAULT, or DB', 400, request.headers.get('origin'))
    }

    const entitlement = await prisma.userServiceEntitlement.findUnique({
      where: {
        userId_service: {
          userId: auth.userId,
          service: service,
        },
      },
    })

    if (!entitlement) {
      return jsonResponse(
        {
          connected: false,
          service,
          message: 'No entitlement found for this service',
        },
        200,
        request.headers.get('origin')
      )
    }

    return jsonResponse(
      {
        connected: (entitlement as any).connected ?? true,
        service: entitlement.service,
        tier: entitlement.tier,
        isPremium: entitlement.isPremium,
      },
      200,
      request.headers.get('origin')
    )
  } catch (error) {
    logger.error('Check connection status error:', error)
    return errorResponse('Internal server error', 500, request.headers.get('origin'))
  }
}

Status Codes

Success (even if no entitlement found)

Bad Request

Missing or invalid service parameter

Unauthorized

Missing or invalid authentication token

Example Request

curl -X GET "https://auth.nullpass.xyz/api/connect/check?service=DROP" \
  -H "Authorization: Bearer YOUR_TOKEN"

Example Response

Connected Service

{
  "connected": true,
  "service": "DROP",
  "tier": "premium",
  "isPremium": true
}

No Entitlement

{
  "connected": false,
  "service": "DROP",
  "message": "No entitlement found for this service"
}

Authorizations

Authorization

string

header

required

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

Query Parameters

service

enum<string>

required

Available options:

DROP,

MAILS,

VAULT,

DB

Response

200 - application/json

Connection status

connected

boolean

service

enum<string>

Available options:

DROP,

MAILS,

VAULT,

DB

tier

string | null

isPremium

boolean | null

Check Service Connection

curl --request GET \
  --url https://auth.nullpass.xyz/api/connect/check \
  --header 'Authorization: Bearer <token>'

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

fetch('https://auth.nullpass.xyz/api/connect/check', 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://auth.nullpass.xyz/api/connect/check",
  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://auth.nullpass.xyz/api/connect/check"

	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://auth.nullpass.xyz/api/connect/check")

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

{
  "connected": true,
  "tier": "<string>",
  "isPremium": true
}

Get Started

Authentication

Services

Webhooks

Account Management

Service Connection

Polar Integration

Admin

Advanced

Library

Check Service Connection

Endpoint

Overview

Request

Query Parameters

Response

Implementation Details

Code Reference

Status Codes

Example Request

Example Response

Connected Service

No Entitlement

Authorizations

Query Parameters

Response

​Endpoint

​Overview

​Request

​Query Parameters

​Response

​Implementation Details

​Code Reference

​Status Codes

​Example Request

​Example Response

​Connected Service

​No Entitlement

Authorizations

Query Parameters

Response

Endpoint

Overview

Request

Query Parameters

Response

Implementation Details

Code Reference

Status Codes

Example Request

Example Response

Connected Service

No Entitlement