List GHL Appointments

curl --request GET \
  --url https://api.ravan.ai/api/v1/ghl/appointments \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.ravan.ai/api/v1/ghl/appointments', 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.ravan.ai/api/v1/ghl/appointments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$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.ravan.ai/api/v1/ghl/appointments"

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

	req.Header.Add("X-Api-Key", "<api-key>")

	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.ravan.ai/api/v1/ghl/appointments")

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

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

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

{
  "success": true,
  "message": "Request completed successfully",
  "data": {
    "appointments": [
      {
        "id": "id_123",
        "ghl_appointment_id": "id_123",
        "contact_id": "id_123",
        "agent_id": "id_123",
        "agent_name": "example",
        "contact_name": "example",
        "contact_email": "alex@example.com",
        "contact_phone": "+14155550100",
        "appointment_time": "2026-03-14T12:00:00Z",
        "status": "active"
      }
    ],
    "count": 1
  }
}

GET

api

ghl

appointments

List GHL Appointments

curl --request GET \
  --url https://api.ravan.ai/api/v1/ghl/appointments \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://api.ravan.ai/api/v1/ghl/appointments', 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.ravan.ai/api/v1/ghl/appointments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Api-Key: <api-key>"
  ],
]);

$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.ravan.ai/api/v1/ghl/appointments"

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

	req.Header.Add("X-Api-Key", "<api-key>")

	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.ravan.ai/api/v1/ghl/appointments")

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

request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'

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

{
  "success": true,
  "message": "Request completed successfully",
  "data": {
    "appointments": [
      {
        "id": "id_123",
        "ghl_appointment_id": "id_123",
        "contact_id": "id_123",
        "agent_id": "id_123",
        "agent_name": "example",
        "contact_name": "example",
        "contact_email": "alex@example.com",
        "contact_phone": "+14155550100",
        "appointment_time": "2026-03-14T12:00:00Z",
        "status": "active"
      }
    ],
    "count": 1
  }
}

Authorizations

string

required

Your Agni API key used to authenticate the request. Pass it in the X-Api-Key header. Find or rotate it from your Ravan AI account settings.

Query Parameters

string

The unique ID of the agent that should own, handle, or be assigned to this resource. Use the id returned by the Agent API.

string

Filters or sets the current status of the resource. Use one of the status values supported by the endpoint.

integer

The maximum number of records to return. Use this with offset or pagination fields to page through results.

string

The organization ID that owns the resource. Use the organization ID from your Agni account.

Response

boolean

Whether the request succeeded.

string

Human-readable status message.

object

data field.

Show data

object[]

appointments field.

Show appointments[]

string

id field.

string

ghl_appointment_id field.

string

contact_id field.

string

agent_id field.

string

agent_name field.

string

contact_name field.

string

contact_email field.

string

contact_phone field.

string

appointment_time field.

string

status field.

integer

count field.

{
  "success": true,
  "message": "Request completed successfully",
  "data": {
    "appointments": [
      {
        "id": "id_123",
        "ghl_appointment_id": "id_123",
        "contact_id": "id_123",
        "agent_id": "id_123",
        "agent_name": "example",
        "contact_name": "example",
        "contact_email": "alex@example.com",
        "contact_phone": "+14155550100",
        "appointment_time": "2026-03-14T12:00:00Z",
        "status": "active"
      }
    ],
    "count": 1
  }
}

Authorizations

X-Api-Key

string

header

required

Query Parameters

agent_id

string

Filter by agent ID

status

string

Filter by appointment status

limit

integer<int32>

default:50

Number of results to return (max 200)

Required range: x <= 200

org_id

string

Organization ID (fallback)

Response

200 - application/json

Successful response

success

boolean

message

string

data

object

Show child attributes

Introduction

Agent API

Organization API

Agent Tool API

Phone Number & Telephony API

Campaign API

Contact API

Calling API

Appointment API

GHL Integration API

Cal.com Integration API

RAG Knowledge Base API

Webhooks

Health API

List GHL Appointments

Authorizations

Query Parameters

Response

Authorizations

Query Parameters

Response

​Authorizations

​Query Parameters

​Response

Authorizations

Query Parameters

Response

Authorizations

Query Parameters

Response