Skip to content

GitLab

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
  • Sign in
  • E ensembl-rest
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 0
    • Issues 0
    • List
    • Boards
    • Service Desk
    • Milestones
    • Iterations
    • Requirements
  • Jira
    • Jira
  • Merge requests 0
    • Merge requests 0
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
    • Test Cases
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Packages & Registries
    • Packages & Registries
    • Package Registry
    • Container Registry
    • Infrastructure Registry
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Code review
    • Insights
    • Issue
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • ensembl-gh-mirror
  • ensembl-rest
  • Wiki
  • Home

Last edited by Marek Szuba Jun 24, 2019
Page history

Home

Ensembl REST APIs

Ensembl REST API Logo

Ensembl REST API provides language agnostic bindings to Ensembl data.

  • Access it from http://rest.ensembl.org
  • Access our GRCh37 site from http://grch37.rest.ensembl.org (click here for more info)

Ensembl REST 11.1 User Guide

The following guide refers to the 11.1 release of the Ensembl REST API. For support please contact helpdesk or our dev mailing list.

Contents

  1. Writing Your First Client
  2. Example Clients (all query for a Gene and look for overlapping variation)
  • Example Java Client
  • Example Perl Client
  • Example Python Client
  • Example Ruby Client
  1. URL Structure
  2. Parameters
  3. API Versioning
  4. Output formats
  5. HTTP Response Codes
  6. HTTP Headers
  7. Rate Limits
  8. Cross Origin Resource Sharing and JSON-P
  9. POST Requests (VEP & Archive)
  10. Version Migration
  • 1.0 to 2.0
  • 1.0 to 3.0 (Beta to Gamma)
  1. REST Installation and Development

Licensing

The Ensembl REST API & associated Ensembl Perl APIs are available under an Apache 2 license. Please consult the LICENSE file for more information. Your usage of the data returned by the service is subject to same conditions as laid out on the Ensembl website.

Citing

If you use the Ensembl REST API please cite Yates et. al. (doi:10.1093/bioinformatics/btu613).

To cite Ensembl data usage, please use Zerbino et. al. (doi.org/10.1093/nar/gkx1098).

If you use the VEP in your work, please cite McLaren et. al. (doi:10.1186/s13059-016-0974-4).

Example Clients

All example clients attempt to find variants overlapping the human Gene BRAF. They also attempt to rate limit themselves to 15 requests per second but also look for the Retry-After header to ensure they are not rate limited due to shared IP addresses.

  • Perl
  • Python
  • Java
  • Ruby
  • Java with Unirest
Clone repository
  • 1.0 To 2.0 Migration
  • 1.0 To 3.0 Migration
  • API Versioning
  • CORS And JSONP
  • Change log
  • Example Java Client with Unirest
  • Example Java Client
  • Example Perl Client
  • Example Python Client
  • Example Ruby Client
  • GRCh37 REST server
  • HTTP Headers
  • HTTP Response Codes
  • Home
  • How to enable the eQTL endpoint
View All Pages