NAV Navbar
cURL
  • Getro API
  • Introduction
  • Pagination
  • Errors
  • GetroJobs
  • Job functions
  • Locations
  • Networks
  • Companies
  • Jobs
  • GetroNetwork
  • Experience levels
  • Talent
  • Getro API

    Introduction

    Welcome to the Getro API! You can use our API to access Getro's API endpoints, which can get information on the companies in your network and their open job positions.

    Authentication

    To authorize, use this code:

    curl -X <TYPE> 'url'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    Make sure to replace email@example.com with your email and password with your API key.

    Getro requires the email and API key associated with a user be included in all API requests to the server in a header that looks like the following:

    X-User-Email: email@example.com
    X-User-Token: password

    Pagination

    The per_page parameter should not be bigger than 100 in order for the system to be reliable.

    Getro requires all API calls that return lists of objects to receive the following pagination parameters:

    page: The number of the page
    per_page: The number of items to return by page

    Errors

    The Getro API uses the following error codes:

    Error Code Meaning
    400 Bad Request -- Your request is invalid.
    401 Unauthorized -- Your API key or email is wrong.
    403 Forbidden -- The info requested is hidden for certain members.
    404 Not Found -- The specified kitten could not be found.
    422 Not Acceptable -- You requested a format that isn't json.
    500 Internal Server Error -- We had a problem with our server. Try again later.
    503 Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

    GetroJobs

    Job functions

    Get all job functions

    curl -X GET 'https://api.getro.com/v2/job_functions'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    

    The above command returns JSON structured like this:

    [
      "Accounting & Finance",
      "Administration",
      "Customer Service",
      "Data Science",
      "Design",
      "IT",
      "Legal",
      "Marketing & Communications",
      "Operations",
      "Other Engineering",
      "People & HR",
      "Product",
      "Quality Assurance",
      "Sales & Business Development",
      "Software Engineering"
    ]
    

    This endpoint retrieves all job functions in the system.

    HTTP Request

    GET https://api.getro.com/v2/job_functions

    Locations

    Get locations for companies

    curl -X GET 'https://api.getro.com/v2/locations/companies'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    

    The above command returns JSON structured like this:

    [
      "Cincinnati, OH, USA",
      "Kharkiv Oblast, Ukraine",
      "Palo Alto, CA, USA",
      "Cortez, CO, USA",
      "Burnsville, MN, USA",
      "Rehovot, Israel",
      "Ra'anana, Israel",
      "Victorias Cross Terrace, Ashburn, VA 20147, USA",
      "Herzogenaurach, Germany",
      "Saratoga Springs Pl, Ashburn, VA 20147, USA"
    ]
    

    This endpoint retrieves locations related with companies. This call gives a maximum number of 10 results

    HTTP Request

    GET https://api.getro.com/v2/locations/companies

    Query Parameters

    Parameter Example Description
    query Boulder If included it will filter results with locations that match this string.

    Get locations for jobs

    curl -X GET 'https://api.getro.com/v2/locations/jobs'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    

    The above command returns JSON structured like this:

    [
      "Cincinnati, OH, USA",
      "Kharkiv Oblast, Ukraine",
      "Palo Alto, CA, USA",
      "Cortez, CO, USA",
      "Burnsville, MN, USA",
      "Rehovot, Israel",
      "Ra'anana, Israel",
      "Victorias Cross Terrace, Ashburn, VA 20147, USA",
      "Herzogenaurach, Germany",
      "Saratoga Springs Pl, Ashburn, VA 20147, USA"
    ]
    

    This endpoint retrieves locations related with jobs. This call gives a maximum number of 10 results.

    HTTP Request

    GET https://api.getro.com/v2/locations/jobs

    Query Parameters

    Parameter Example Description
    query Boulder If included it will filter results with locations that match this string.

    Networks

    Get all networks

    curl -X GET 'https://api.getro.com/v2/networks'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    The above command returns JSON structured like this:

    {
      "items": [
        {
          "id": 99,
          "name": "Demo Network",
          "logo_url": "https://cdn.filepicker.io/api/file/BMSXkyiQSTuQ3qwX3opX"
        }
      ],
      "meta": {
        "total": 1
      }
    }
    

    This endpoint retrieves information about your networks.

    HTTP Request

    GET https://api.getro.com/v2/networks

    Get a specific network

    curl -X GET 'https://api.getro.com/v2/network/99'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    The above command returns JSON structured like this:

    {
      "id": 99,
      "name": "Demo Network",
      "tagline": "",
      "subtitle": "",
      "topics": [
        "Ad Tech",
        "Affordable And Clean Energy",
        "CEO Pledge",
        "Clean Energy",
        "Decent Work And Economic Growth",
        "Energy",
        "Enterprise",
        "Gender Equality",
        "Good Health And Well-Being",
        "Industry, Innovation And Infrastructure",
        "No poverty",
        "Outdoor",
        "Peace, justice and strong institutions",
        "Quality Education",
        "Responsible Consumption And Production",
        "Rotr seed",
        "Software & services",
        "Sustainable Cities And Communities",
        "Tech and Telecom",
        "Zero hunger"
      ],
      "domain": "demo.com",
      "logo_url": "https://cdn.filepicker.io/api/file/BMSXkyiQSTuQ3qwX3opX",
      "main_image_url": "https://cdn.filepicker.io/api/file/Rf8iIKXxSyCLrpRaxkXN"
    }
    

    This endpoint retrieves information about a given network ID.

    HTTP Request

    GET https://api.getro.com/v2/networks/:id

    Companies

    Get all companies

    This endpoint retrieves all companies in a network.

    curl -X GET 'https://api.getro.com/v2/networks/:id/companies?name=Getro&topics=Health&job_functions=Legal
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    HTTP Request

    GET https://api.getro.com/v2/networks/:id/companies

    The above command returns JSON structured like this:

    {
      "items": [
        {
          "description": "We help companies hire faster by identifying referred candidates from sources they trust. Professionals get warm introductions to companies they're interested in working for.",
          "domain": "getro.com",
          "id": 894,
          "locations": [
            "New York, NY, USA",
            "Boulder, CO, USA"
          ],
          "logo_url": "https://assets.techstars.com/images/image_files/5920e3939c66a93647000009/original/MarkBlush.png",
          "name": "Getro",
          "slug": "getro",
          "topics": ['Health', 'Legal']
        }
      ],
      "meta": {
        "total": 1
      }
    }
    

    Query Parameters

    Parameter Example Description
    name 'Getro' If included it will filter results with organizations which name match this field.
    topics* 'Energy' If the string is not empty, the result will include organizations with organizations matching the topics provided.
    job_functions* 'Software Engineering' If the string is not empty, the result will include organizations with open jobs matching the job functions provided.
    locations* 'Boulder, CO, USA' If the string is not empty, the result will include organizations with headquarters in the locations provided. Each element of the array needs to be a Google place ID or one of the following options: remote, earth.
    page** 1 The page selected will help you offset the result through pagination.
    per_page** 9 The number of organizations included in each page.

    * String separated by |
    ** Required parameter

    Get a specific company

    This endpoint retrieves a specific company's information within the network.

    curl -X GET 'https://api.getro.com/v2/networks/:id/companies/:id'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    The above command returns JSON structured like this:

    {
      "id": 894,
      "name": "Getro",
      "logo_url": "https://assets.techstars.com/images/image_files/5920e3939c66a93647000009/original/MarkBlush.png",
      "tagline": "Getro makes hiring easier by connecting employers to referred professionals in their network.",
      "domain": "getro.com",
      "description": "We help companies hire faster by identifying referred candidates from sources they trust. Professionals get warm introductions to companies they're interested in working for.",
      "locations": [
        "New York, NY, USA",
        "Boulder, CO, USA"
      ],
      "topics": ['Health'],
      "slug": "getro"
    }
    

    HTTP Request

    GET https://api.getro.com/v2/networks/:id/companies/:id

    Jobs

    Search jobs

    This endpoint searches through jobs in your network.

    curl -X GET 'https://api.getro.com/v2/networks/:id/jobs?title=Job&job_functions=Software%20Engineering%7CHealth'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    HTTP Request

    GET https://api.getro.com/v2/networks/:id/jobs

    The above command returns JSON structured like this:

    {
      "items": [
        {
          "created_at": "2017-05-15T09:46:14.426Z",
          "id": 150809,
          "job_functions": ["Software Engineering"],
          "locations": ["Boulder, CO, USA"],
          "company": {
            "id": 991,
            "name": "Wunder",
            "logo_url": "https://assets.techstars.com/images/image_files/56a80c65808320c406000004/original/logo.png",
            "slug": "wunder",
            "topics": []
          },
          "title": "Your Dream Job",
          "url": "http://assets.wundercapital.com/openings/dream_job.pdf"
        },
        ...
      ],
      "meta": {
        "total": 20
      }
    }
    

    Query Parameters

    Parameter Example Description
    title Sales Engineer If included, the result will show all jobs that match the job title specified.
    locations* 'Boulder, CO, USA' If the string is not empty, the result will include jobs based out of the the locations provided. Each element of the array needs to be a Google place ID or one of the following options: remote, earth.
    job_functions* 'Software Engineering' If the string is not empty, the result will include open jobs matching the job functions specified.
    companies* 'Getro' If the string is not empty, the result will include open jobs associated with the companies provided.
    topics* 'Energy' If the string is not empty, the result will include jobs with companies matching the topics provided.
    page** 1 The page selected will help you offset the result through pagination.
    per_page** 9 The number of jobs included in each page.

    * String separated by |
    ** Required parameter

    Search removed jobs

    This endpoint searches through removed jobs in the database.

    curl -X GET 'https://api.getro.com/v2/networks/:id/jobs/removed?deactivated_from=2017-05-01&companies=Getro'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    HTTP Request

    GET https://api.getro.com/v2/networks/:id/jobs/removed

    The above command returns JSON structured like this:

    {
      "items": [
        {
          "created_at": "2017-05-15T09:46:14.426Z",
          "deactivated_at": "2018-01-15T18:10:11.217Z",
          "id": 150809,
          "job_functions": ["Software Engineering"],
          "locations": ["Boulder, CO, USA"],
          "company": {
            "id": 991,
            "name": "Wunder",
            "logo_url": "https://assets.techstars.com/images/image_files/56a80c65808320c406000004/original/logo.png",
            "slug": "wunder",
            "topics": []
          },
          "title": "Your Dream Job",
          "url": "http://assets.wundercapital.com/openings/dream_job.pdf"
        },
        ...
      ],
      "meta": {
        "total": 2
      }
    }
    

    Query Parameters

    Parameter Example Description
    title Sales Engineer If included, the result will show all jobs that match the job title specified.
    deactivated_from '2018-01-01' The start date in a range to see deactivated jobs.
    deactivated_to '2018-01-31' The end date in a range to see deactivated jobs. If not set, will use current date
    locations* 'Boulder, CO, USA' If the string is not empty, the result will include jobs based out of the the locations provided. Each element of the array needs to be a Google place ID or one of the following options: remote, earth.
    job_functions* 'Software Engineering' If the string is not empty, the result will include open jobs matching the job functions specified.
    companies* 'Getro' If the string is not empty, the result will include open jobs associated with the companies provided.
    topics* 'Energy' If the string is not empty, the result will include jobs with companies matching the topics provided.
    page** 1 The page selected will help you offset the result through pagination.
    per_page** 9 The number of jobs included in each page.

    * String separated by |
    ** Required parameter

    GetroNetwork

    Experience levels

    Get experience levels

    curl -X GET 'experience_levels'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    

    The above command returns JSON structured like this:

    [
      "job_level_unspecified",
      "entry_level",
      "experienced",
      "manager",
      "director",
      "executive"
    ]
    

    This endpoint retrieves all experience levels in the system.

    HTTP Request

    GET https://api.getro.com/v2/experience_levels

    Talent

    Search talent

    This endpoint searches talent members within the network.

    curl -X GET 'https://api.getro.com/v2/networks/:id/talent
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    HTTP Request

    GET https://api.getro.com/v2/networks/:id/talent

    The above command returns JSON structured like this:

    {
      "items": [
        {
          "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
          "bio": "CTO | Co-founder of Getro",
          "cover_letter": "I'm a Techstars Founder (Boulder '17) and I believe I can help others in the network find great opportunities.",
          "email": "raul@getro.com",
          "first_name": "Raul",
          "id": 6413,
          "introductions_received": [
            {
              "created_at": "2018-02-23T15:22:45.664Z",
              "company": {
                "id": 102,
                "name": "FullContact",
                "logo_url": "https://cdn.filestackcontent.com/J27COtSnQLE7Xp2RpHEl",
                "description": "FullContact is the most powerful fully-connected contact management platform for professionals and enterprises who need to master their contacts and be awesome with people. FullContact's cross-platform suite of Apps and APIs enhance contacts with insights, while keeping them organized, synchronized, up to date, and safe.",
                "topics": []
              },
              "status": "sent"
            }
          ],
          "introductions_requested": [
            {
              "created_at": "2018-11-27T06:39:24.893Z",
              "user": {
                "name": "Michael Mundy",
                "email": "m@mundy.com",
                "linkedin_url": null,
                "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
                "bio": "Writer. Traveler. Book/Music/Film/TV/Soccer enthusiast."
              },
              "status": "sent"
            }
          ],
          "last_name": "San N.H.",
          "linkedin_url": "http://www.linkedin.com/in/raulsann",
          "seniority": "manager",
          "share_permission": true,
          "job_functions": [
            "Software Engineering"
          ],
          "locations": [
            "Boulder, CO, USA"
          ],
          "verified": true,
          "vouches": [
            {
              "created_at": "2018-10-08T18:43:55.373Z",
              "recommendation_text": "Evan is the best communicator, the best hustler, and opportunity-hacker I know. He is a people Expert, with capital 'E'. I'm incredibly grateful and lucky to work, live, and have adventures around the world with him.Evan is the best communicator, the best hustler, and opportunity-hacker I know. He is a people Expert, with capital 'E'. I'm incredibly grateful and lucky to work, live, and have adventures around the world with him.",
              "score": 5,
              "voucher": {
                "name": "Raul San N.H.",
                "email": "raul@getro.com",
                "linkedin_url": "http://www.linkedin.com/in/raulsann",
                "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
                "bio": "CTO | Co-founder of Getro"
              }
            }
          ]
        }
        ...
      ],
      "meta": {
        "total_items": 960,
        "total_pages": 32,
        "current_page": 1,
        "next_page": 2
      }
    }
    

    Query Parameters

    Parameter Example Description
    name 'Raul' If included, the result will show all talent who match the name field specified.
    email '@getro.com' If included, the result will show all talent who match the email field specified.
    job_functions* 'Software Engineering' If the string is not empty, the result will include talent whose profiles include the job functions provided.
    locations* 'Boulder, CO, USA' If the string is not empty, the result will include talent whose profiles indicate willingness to work in the locations provided.
    experience_level 'manager' If the string is not empty, the result will include talent whose profiles match the experience level provided.
    vouched true If marked as true, the result will include talent who have been vouched for by a verified member in the network.
    not_visible_profiles true If marked as true, the result will include talent who have marked their profile as not visible in the network.
    page** 1 The page selected will help you offset the result through pagination.
    per_page** 9 The number of organizations included in each page.

    * String separated by |
    ** Required parameter

    Get talent member

    This endpoint retrieves a specific talent member.

    curl -X GET 'https://api.getro.com/v2/networks/:id/talent/:id'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: email@example.com'
    --header 'X-User-Token: password'
    

    The above command returns JSON structured like this:

    {
      "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
      "bio": "CTO | Co-founder of Getro",
      "cover_letter": "I'm a Techstars Founder (Boulder '17) and I believe I can help others in the network find great opportunities.",
      "email": "raul@getro.com",
      "first_name": "Raul",
      "id": 6413,
      "introductions_received": [
        {
          "created_at": "2018-02-23T15:22:45.664Z",
          "company": {
            "id": 102,
            "name": "FullContact",
            "logo_url": "https://cdn.filestackcontent.com/J27COtSnQLE7Xp2RpHEl",
            "description": "FullContact is the most powerful fully-connected contact management platform for professionals and enterprises who need to master their contacts and be awesome with people. FullContact's cross-platform suite of Apps and APIs enhance contacts with insights, while keeping them organized, synchronized, up to date, and safe.",
            "topics": []
          },
          "status": "sent"
        }
      ],
      "introductions_requested": [
        {
          "created_at": "2018-11-27T06:39:24.893Z",
          "user": {
            "name": "Michael Mundy",
            "email": "m@mundy.com",
            "linkedin_url": null,
            "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
            "bio": "Writer. Traveler. Book/Music/Film/TV/Soccer enthusiast."
          },
          "status": "sent"
        }
      ],
      "last_name": "San N.H.",
      "linkedin_url": "http://www.linkedin.com/in/raulsann",
      "seniority": "manager",
      "share_permission": true,
      "job_functions": [
        "Software Engineering"
      ],
      "locations": [
        "Boulder, CO, USA"
      ],
      "verified": true,
      "vouches": [
        {
          "created_at": "2018-10-08T18:43:55.373Z",
          "recommendation_text": "Evan is the best communicator, the best hustler, and opportunity-hacker I know. He is a people Expert, with capital 'E'. I'm incredibly grateful and lucky to work, live, and have adventures around the world with him.Evan is the best communicator, the best hustler, and opportunity-hacker I know. He is a people Expert, with capital 'E'. I'm incredibly grateful and lucky to work, live, and have adventures around the world with him.",
          "score": 5,
          "voucher": {
            "name": "Raul San N.H.",
            "email": "raul@getro.com",
            "linkedin_url": "http://www.linkedin.com/in/raulsann",
            "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
            "bio": "CTO | Co-founder of Getro"
          }
        }
      ]
    }
    
    

    HTTP Request

    GET https://api.getro.com/v2/networks/:id/talent/:id