ExpertFile Documentation
  • 👋Welcome!
  • Reference
    • API Reference
      • Authentication
      • Experts
        • Expert Directory/Search
        • Expert Profile
          • Accomplishments
          • Affiliations
          • Article
          • Availability
          • Biography
          • Categories
          • Course
          • Education
          • Event Appearances
          • Fees
          • Industries
          • Languages
          • Links
          • Media Appearances
          • Partnerships
          • Patents
          • Research Focus
          • Research Grants
          • Sample Talks
          • Social
          • Tagline
          • Tags
          • Testimonials
          • Topics
          • SEO/Meta Data
      • Staff
        • Staff Directories/Search
        • Staff Profiles
          • Biography
          • Categories
          • Education
          • Languages
          • Links
          • Tagline
          • Tags
      • Inquiries
        • Admission
        • Business
        • Donor
        • Event
        • Expert Witness
        • General
        • Media
        • Meeting
        • Partnership
        • Research
      • Posts (Spotlights)
        • Post Listings/Search
        • Full Post
      • Q&A (Answers)
        • Q&A Listings/Search
        • Individual Q&A
    • Embeds
      • Expert Directory/Search
      • Expert & Staff Profiles
        • Adding Profile Meta Data
      • Featured Experts
      • Inquiries
      • Post Listings/Search
      • Full Post
        • Adding Post Meta Data
      • Q&A Listings/Search
      • Individual Q&A
        • Adding Q&A Meta Data
      • Adding Meta Data to Embeds
    • WordPress
      • Expert Directory/Search
      • Expert & Staff Profiles
      • Featured Experts
      • Inquiries
      • Q&A Listings/Search
      • Individual Q&A
      • Post Listings/Search
      • Full Post
    • Tracking Code (Analytics)
    • Adding Meta Data for SEO
    • Helpers
Powered by GitBook
On this page
  • Listing Employees Or Staff
  • Applying Category Filter to Employees or Staff

Was this helpful?

  1. Reference
  2. API Reference
  3. Staff

Staff Directories/Search

You can return just staff profiles or both staff and expert. Specify staff or employee will return staff of both user types.

PreviousStaffNextStaff Profiles

Last updated 1 year ago

Was this helpful?

Remember to change :corporation with your corporation id(found in the integrations section of the dashboard).

Listing Employees Or Staff

GET

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Url

Name
Type
Description

corporation

number

Corporation ID

username

string

Unique username

type

string

staff/employee

q

string

Keyword search term

access

string

public/private/all

status

string

published/unpublished/all

page_size

number

Size of page

page_from

number

Starting point

categories

string

Filter by categories. Array of categories(i.e. ["cat1","cat2"])

tags

string

Filter by tags. Array of tags(i.e. ["tag1","tag2"])

sort

string

Sorting order(name/featured)

searchfield

string

Fullname to query only name field.

Response

{
  data: {
    employees|staff: [],
    total: 10
  },
  success: true
}  

Code

const accessToken = `<ACCESS TOKEN>`

fetch('https://public-api.expertfile.com/v2/organization/:corporation/employee', {
    method: 'GET',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    }
})
.then(response => response.json())
.then(json => {
    const { success, data } = json

    if (success) {
        const { employees, total } = data;
        console.log('Employees', employees, total);
    }

})
.catch(error => console.error(error));
$accessToken = urlencode('<ACCESS TOKEN>');
$url = 'https://public-api.expertfile.com/v2/organization/:corporation/employee';

$ch = curl_init($url);
curl_setopt(
    $ch,
    CURLOPT_HTTPHEADER,
    array('Content-Type: application/x-www-form-urlencoded', 'Authorization: Bearer ' . $accessToken)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$json = json_decode($response);

if($json->success){
    var_dump($json->data);
}

curl_close($ch);
curl https://public-api.expertfile.com/v2/organization/:corporation/employee \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <ACCESS TOKEN>"

Applying Category Filter to Employees or Staff

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Url

Name
Type
Description

corporation

number

Corporation ID

type

string

staff/employee

categories

string

Filter by categories. Array of categories(i.e. ["cat1","cat2"])

Response

{
  data: {
    employees|staff: [],
    total: 10
  },
  success: true
}  

Code

const accessToken = `<ACCESS TOKEN>`

const params = {
    categories: JSON.stringify(['Advisors', 'Featured'])
};

const qs = new URLSearchParams(params).toString()

const path = `https://public-api.expertfile.com/v2/organization/:corporation/employee${qs ? '?' + qs : ''}`
fetch(path, {
    method: 'GET',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    }
})
.then(response => response.json())
.then(json => {
    const { success, data } = json

    if (success) {
        const { employees, total } = data;
        console.log('Employees', employees, total);
    }

})
.catch(error => console.error(error));
$accessToken = urlencode('<ACCESS CODE>');
$parameters = array(
    'categories' => json_encode(['Advisors', 'Featured'])
);

$url = 'https://public-api.expertfile.com/v2/organization/:corporation/expert?' . http_build_query($parameters);

$ch = curl_init($url);
curl_setopt(
    $ch,
    CURLOPT_HTTPHEADER,
    array('Content-Type: application/x-www-form-urlencoded', 'Authorization: Bearer ' . $accessToken)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$json = json_decode($response);

if($json->success){
    var_dump($json->data);
}

curl_close($ch);
curl --GET \
--data-urlencode 'categories=["Advisors","Featured"]' \
https://public-api.expertfile.com/v2/organization/:corporation/expert \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS CODE>"

GET

/v2/organization/:corporation/:type
/v2/organization/:corporation/:type