{
  "info": {
    "name": "VoiceCallingAI API (v1)",
    "description": "Public REST API for VoiceCallingAI. Set the `baseUrl` and `apiKey` collection variables, then run any request. Generated from openapi.yaml (version 2026-06-04).",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.voicecallingai.com/v1"
    },
    {
      "key": "apiKey",
      "value": "vca_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  ],
  "item": [
    {
      "name": "Calls",
      "item": [
        {
          "name": "List calls",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/calls?limit=2",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "calls"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "2"
                }
              ]
            }
          }
        },
        {
          "name": "Create a call",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/calls",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "calls"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"agent_id\": \"YOUR_AGENT_ID\",\n  \"to\": \"+9198xxxxxxxx\",\n  \"variables\": {\n    \"name\": \"Harsh\"\n  },\n  \"external_ref\": \"crm-lead-4821\"\n}"
            }
          }
        },
        {
          "name": "Get a call",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/calls/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "calls",
                ":id"
              ]
            }
          }
        },
        {
          "name": "Get a call transcript (coming soon)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/calls/:id/transcript",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "calls",
                ":id",
                "transcript"
              ]
            }
          }
        },
        {
          "name": "Get a recording URL (coming soon)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/calls/:id/recording",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "calls",
                ":id",
                "recording"
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Call requests",
      "item": [
        {
          "name": "List call requests",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/call-requests?limit=2",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "call-requests"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "2"
                }
              ]
            }
          }
        },
        {
          "name": "Get a call request",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/call-requests/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "call-requests",
                ":id"
              ]
            }
          }
        },
        {
          "name": "Cancel a queued call request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/call-requests/:id/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "call-requests",
                ":id",
                "cancel"
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Contacts",
      "item": [
        {
          "name": "List contacts",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/contacts",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "contacts"
              ]
            }
          }
        },
        {
          "name": "Create a contact",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/contacts",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "contacts"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_e164\": \"+9198xxxxxxxx\",\n  \"name\": \"Harsh\"\n}"
            }
          }
        },
        {
          "name": "Get a contact",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/contacts/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "contacts",
                ":id"
              ]
            }
          }
        },
        {
          "name": "Update a contact",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/contacts/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "contacts",
                ":id"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Harsh\"\n}"
            }
          }
        }
      ]
    },
    {
      "name": "Opt-outs",
      "item": [
        {
          "name": "Opt a number out",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/opt-outs",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "opt-outs"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_e164\": \"+9198xxxxxxxx\",\n  \"reason\": \"customer requested\"\n}"
            }
          }
        },
        {
          "name": "Check opt-out state",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/opt-outs/:phone_e164",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "opt-outs",
                ":phone_e164"
              ]
            }
          }
        },
        {
          "name": "Clear an opt-out",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/opt-outs/:phone_e164",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "opt-outs",
                ":phone_e164"
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Wallet",
      "item": [
        {
          "name": "Get wallet balance",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/wallet",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "wallet"
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Webhook subscriptions",
      "item": [
        {
          "name": "List subscriptions",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-subscriptions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-subscriptions"
              ]
            }
          }
        },
        {
          "name": "Create a subscription",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-subscriptions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-subscriptions"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"My CRM\",\n  \"url\": \"https://example.com/hooks/voicecallingai\",\n  \"events\": [\n    \"call.answered\",\n    \"call.completed\",\n    \"webhook.test\"\n  ]\n}"
            }
          }
        },
        {
          "name": "Update a subscription",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-subscriptions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-subscriptions",
                ":id"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"paused\"\n}"
            }
          }
        },
        {
          "name": "Delete a subscription",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-subscriptions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-subscriptions",
                ":id"
              ]
            }
          }
        },
        {
          "name": "Rotate signing secret",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-subscriptions/:id/rotate-secret",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-subscriptions",
                ":id",
                "rotate-secret"
              ]
            }
          }
        },
        {
          "name": "Send a test event",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{apiKey}}"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook-subscriptions/:id/test",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-subscriptions",
                ":id",
                "test"
              ]
            }
          }
        }
      ]
    }
  ]
}