NAV Navbar
cURL
  • Monday API
  • Introduction
  • Pagination
  • Errors
  • Job Board
  • Job functions
  • Locations
  • Collections
  • Organizations
  • Jobs
  • Talent Network
  • Seniorities
  • Talent
  • Monday API

    Introduction

    Welcome to the Monday API! You can use our API to access Monday's API endpoints, which can get information on the organizations 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: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    Make sure to replace someone@monday.vc with your email and happymonday with your API key.

    Monday expects for the User email and the API key to be included in all API requests to the server in a header that looks like the following:

    X-User-Email: someone@monday.vc
    X-User-Token: happymonday

    Pagination

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

    Monday expects for the 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 Monday 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.

    Job Board

    Job functions

    Get All Job Functions

    curl -X GET 'https://api.monday.vc/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 public in the system.

    HTTP Request

    GET https://api.monday.vc/v2/job_functions

    Locations

    Get Locations for Organizations

    curl -X GET 'https://api.monday.vc/v2/locations/organizations'
    --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 Organizations. This call gives a maximum number of 10 results

    HTTP Request

    GET https://api.monday.vc/v2/locations/organizations

    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.monday.vc/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.monday.vc/v2/locations/jobs

    Query Parameters

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

    Collections

    Get all Collections

    curl -X GET 'https://api.monday.vc/v2/collections'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    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 Collections.

    HTTP Request

    GET https://api.monday.vc/v2/collections

    Get a specific Collection

    curl -X GET 'https://api.monday.vc/v2/collections/99'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    The above command returns JSON structured like this:

    {
      "collection": {
        "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 Collection.

    HTTP Request

    GET https://api.monday.vc/v2/collections/:id

    Organizations

    Get All Organizations

    This endpoint retrieves all organizations.

    curl -X GET 'https://api.monday.vc/v2/collections/:id/organizations?name=Monday&topics=Health&job_functions=Legal
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    HTTP Request

    GET https://api.monday.vc/v2/collections/:id/organizations

    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": "monday.vc",
          "id": 894,
          "locations": [
            "New York, NY, USA",
            "Boulder, CO, USA"
          ],
          "logo_url": "https://assets.techstars.com/images/image_files/5920e3939c66a93647000009/original/MarkBlush.png",
          "name": "Monday",
          "slug": "monday",
          "topics": ['Health', 'Legal']
        }
      ],
      "meta": {
        "total": 1
      }
    }
    

    Query Parameters

    Parameter Example Description
    name 'Monday' 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 Organization

    This endpoint retrieves an specific organization.

    curl -X GET 'https://api.monday.vc/v2/collections/:id/organizations/:id'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    The above command returns JSON structured like this:

    {
      "organization": {
        "id": 894,
        "name": "Monday",
        "logo_url": "https://assets.techstars.com/images/image_files/5920e3939c66a93647000009/original/MarkBlush.png",
        "tagline": "Monday makes hiring easier by connecting employers to referred professionals in their network.",
        "domain": "monday.vc",
        "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": "monday"
      }
    }
    

    HTTP Request

    GET https://api.monday.vc/v2/collections/:id/organization/:id

    Jobs

    Search Jobs

    This endpoint search through jobs in the database.

    curl -X GET 'https://api.monday.vc/v2/collections/:id/jobs?title=Job&job_functions=Software%20Engineering%7CHealth'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    HTTP Request

    GET https://api.monday.vc/v2/collections/:id/jobs

    The above command returns JSON structured like this:

    {
      "items": [
        {
          "created_at": "2017-05-15T09:46:14.426Z",
          "job_functions": ["Software Engineering"],
          "locations": ["Boulder, CO, USA"],
          "organization": {
            "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",
          "id": 150809
        },
        ...
      ],
      "meta": {
        "total": 20
      }
    }
    

    Query Parameters

    Parameter Example Description
    title Sales Engineer If included it will filter results with a job title that match this field.
    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 jobs with open jobs matching the job functions provided.
    organizations* 'Monday' If the string is not empty, the result will include jobs of the organizations provided.
    topics* 'Energy' If the string is not empty, the result will include jobs with organizations 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 Deactivated Jobs

    This endpoint search through deactivated jobs in the database.

    curl -X GET 'https://api.monday.vc/v2/collections/:id/jobs/deactivated?deactivated_from=2017-05-01&organizations=Monday'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    HTTP Request

    GET https://api.monday.vc/v2/collections/:id/jobs/deactivated

    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"],
          "organization": {
            "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 it will filter results with a job title that match this field.
    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 jobs with open jobs matching the job functions provided.
    organizations* 'Monday' If the string is not empty, the result will include jobs of the organizations provided.
    topics* 'Energy' If the string is not empty, the result will include jobs with organizations 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

    Talent Network

    Seniorities

    Get Seniority Levels

    curl -X GET 'seniority_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 seniority levels public in the system.

    HTTP Request

    GET https://api.monday.vc/v2/seniority_levels

    Talent

    Search Talent

    This endpoint searches Talent members within the Network.

    curl -X GET 'https://api.monday.vc/v2/collections/:id/talent
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    HTTP Request

    GET https://api.monday.vc/v2/collections/: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 Monday.vc",
          "cover_letter": "I'm a Techstars Founder (Boulder '17) and I believe I can help others in the network find great opportunities.",
          "email": "raul@monday.vc",
          "first_name": "Raul",
          "id": 6413,
          "introductions_received": [
            {
              "created_at": "2018-02-23T15:22:45.664Z",
              "organization": {
                "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@monday.vc",
                "linkedin_url": "http://www.linkedin.com/in/raulsann",
                "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
                "bio": "CTO | Co-founder of Monday.vc"
              }
            }
          ]
        }
        ...
      ],
      "meta": {
        "total_items": 960,
        "total_pages": 32,
        "current_page": 1,
        "next_page": 2
      }
    }
    

    Query Parameters

    Parameter Example Description
    name 'Raul' If included it will filter results with talent which name contains this field.
    email '@monday.vc' If included it will filter results with talent which email contains this field.
    job_functions* 'Software Engineering' If the string is not empty, the result will include talent matching the job functions provided.
    locations* 'Boulder, CO, USA' If the string is not empty, the result will include talent matching the locations provided.
    seniority 'manager' If the string is not empty, the result will include talent matching the seniority provided.
    vouched true If marked as true, the result will include talent that has been vouched by a manager or connector within the Network.
    private_profiles true If marked as true, the result will include talent that has marked their profile as private within 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 an specific talent member.

    curl -X GET 'https://api.monday.vc/v2/collections/:id/talent/:id'
    --header 'Content-Type: application/json'
    --header 'Accept: application/json'
    --header 'X-User-Email: someone@monday.vc'
    --header 'X-User-Token: happymonday'
    

    The above command returns JSON structured like this:

    {
      "talent": {
        "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
        "bio": "CTO | Co-founder of Monday.vc",
        "cover_letter": "I'm a Techstars Founder (Boulder '17) and I believe I can help others in the network find great opportunities.",
        "email": "raul@monday.vc",
        "first_name": "Raul",
        "id": 6413,
        "introductions_received": [
          {
            "created_at": "2018-02-23T15:22:45.664Z",
            "organization": {
              "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@monday.vc",
              "linkedin_url": "http://www.linkedin.com/in/raulsann",
              "avatar_url": "https://cdn.filepicker.io/api/file/T95OkklvQvC7duZnJ48M",
              "bio": "CTO | Co-founder of Monday.vc"
            }
          }
        ]
      }
    }
    
    

    HTTP Request

    GET https://api.monday.vc/v2/collections/:id/talent/:id