Skip to main content
GET
/
agents
/
pending
Retrieve pending agent invitations
curl --request GET \
  --url https://api.getfernand.com/agents/pending \
  --header 'X-API-Key: <api-key>'
import requests

url = "https://api.getfernand.com/agents/pending"

headers = {"X-API-Key": "<api-key>"}

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

print(response.text)
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.getfernand.com/agents/pending', 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.getfernand.com/agents/pending",
  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;
}
require 'uri'
require 'net/http'

url = URI("https://api.getfernand.com/agents/pending")

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
package main

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

func main() {

	url := "https://api.getfernand.com/agents/pending"

	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))

}
using RestSharp;


var options = new RestClientOptions("https://api.getfernand.com/agents/pending");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-API-Key", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);
HttpResponse<String> response = Unirest.get("https://api.getfernand.com/agents/pending")
  .header("X-API-Key", "<api-key>")
  .asString();
[
  {
    "id": 42,
    "name": "Richard Hendricks",
    "email": "richard.hendricks@piedpiper.com",
    "roles": [
      "conversation.create",
      "conversation.reply"
    ],
    "avatar": "https://api.getfernand.com/contacts/richard.hendricks@piedpiper.com/avatar",
    "last_email_sent_ts": 1234567890000
  }
]
{
  "error": "<string>"
}
Returns all pending agent invitations for the organization.

Authorizations

X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Response

Successfully retrieved pending invitations. Returns empty array if actor lacks teammate.invite permission.

id
integer<int32>
required

Unique identifier for the agent invitation

Example:

42

name
string
required

Display name derived from the email address (before @ symbol, formatted)

Example:

"Richard Hendricks"

email
string<email>
required

Email address of the invited agent

Maximum string length: 250
Example:

"richard.hendricks@piedpiper.com"

roles
string[]
required

List of permission roles to be assigned when the invite is accepted

Example:
["conversation.create", "conversation.reply"]
avatar
string<uri>
required

Avatar's URL of the user

Example:

"https://api.getfernand.com/contacts/richard.hendricks@piedpiper.com/avatar"

last_email_sent_ts
integer<int64>
required

Unix timestamp (milliseconds) when the invitation email was last sent

Example:

1234567890000