GET homology/id/:id

Retrieves homology information (orthologs) by Ensembl gene id

Parameters

Required

NameTypeDescriptionDefaultExample Values
id String An Ensembl stable ID - AT3G52430

Optional

NameTypeDescriptionDefaultExample Values
aligned Boolean Return the aligned string if true. Otherwise, return the original sequence (no insertions) 1 -
callback String Name of the callback subroutine to be returned by the requested JSONP response. Required ONLY when using JSONP as the serialisation method. Please see the user guide. - randomlygeneratedname
cigar_line Boolean Return the aligned sequence encoded in CIGAR format 1 -
compara String Name of the compara database to use. Multiple comparas can exist on a server if you are accessing Ensembl Genomes data plants plants
format Enum(full, condensed) Layout of the response full -
sequence Enum(none, cdna, protein) The type of sequence to bring back. Setting it to none results in no sequence being returned protein -
species String Species name/alias - arabidopsis_thaliana
Arabidopsis thaliana
target_species String Filter by species. Supports all species aliases - Arabidopsis thaliana
arabidopsis lyrata
target_taxon Integer Filter by taxon - 3702
81972
type Enum(orthologues, paralogues, projections, all) The type of homology to return from this call. Projections are orthology calls defined between alternative assemblies and the genes shared between them. Useful if you need only one type of homology back from the service all -

Example Requests

/homology/id/AT3G52430?content-type=application/json


use strict;
use warnings;

use HTTP::Tiny;

my $http = HTTP::Tiny->new();

my $server = 'http://test.rest.ensemblgenomes.org';
my $ext = '/homology/id/AT3G52430?';
my $response = $http->get($server.$ext, {
  headers => { 'Content-type' => 'application/json' }
});

die "Failed!\n" unless $response->{success};


use JSON;
use Data::Dumper;
if(length $response->{content}) {
  my $hash = decode_json($response->{content});
  local $Data::Dumper::Terse = 1;
  local $Data::Dumper::Indent = 1;
  print Dumper $hash;
  print "\n";
}

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?"

r = requests.get(server+ext, headers={ "Content-Type" : "application/json"})

if not r.ok:
  r.raise_for_status()
  sys.exit()

decoded = r.json()
print repr(decoded)

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?"

r = requests.get(server+ext, headers={ "Content-Type" : "application/json"})

if not r.ok:
  r.raise_for_status()
  sys.exit()

decoded = r.json()
print(repr(decoded))

require 'net/http'
require 'uri'

server='http://test.rest.ensemblgenomes.org'
path = '/homology/id/AT3G52430?'

url = URI.parse(server)
http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(path, {'Content-Type' => 'application/json'})

response = http.request(request)

if response.code != "200"
  puts "Invalid response: #{response.code}"
  puts response.body
  exit
end


require 'rubygems'
require 'json'
require 'yaml'

result = JSON.parse(response.body)
puts YAML::dump(result)

import java.net.URL;
import java.net.URLConnection;
import java.net.HttpURLConnection;
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.IOException;
import java.io.Reader;


public class EnsemblRest {

  public static void main(String[] args) throws Exception {
    String server = "http://test.rest.ensemblgenomes.org";
    String ext = "/homology/id/AT3G52430?";
    URL url = new URL(server + ext);

    URLConnection connection = url.openConnection();
    HttpURLConnection httpConnection = (HttpURLConnection)connection;
    
    httpConnection.setRequestProperty("Content-Type", "application/json");
    

    InputStream response = connection.getInputStream();
    int responseCode = httpConnection.getResponseCode();

    if(responseCode != 200) {
      throw new RuntimeException("Response code was not 200. Detected response was "+responseCode);
    }

    String output;
    Reader reader = null;
    try {
      reader = new BufferedReader(new InputStreamReader(response, "UTF-8"));
      StringBuilder builder = new StringBuilder();
      char[] buffer = new char[8192];
      int read;
      while ((read = reader.read(buffer, 0, buffer.length)) > 0) {
        builder.append(buffer, 0, read);
      }
      output = builder.toString();
    } 
    finally {
        if (reader != null) try {
          reader.close(); 
        } catch (IOException logOrIgnore) {
          logOrIgnore.printStackTrace();
        }
    }

    System.out.println(output);
  }
}


curl 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?' -H 'Content-type:application/json'

wget -q --header='Content-type:application/json' 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?'  -O -

/homology/id/AT3G52430?content-type=text/xml;compara=plants


use strict;
use warnings;

use HTTP::Tiny;

my $http = HTTP::Tiny->new();

my $server = 'http://test.rest.ensemblgenomes.org';
my $ext = '/homology/id/AT3G52430?compara=plants';
my $response = $http->get($server.$ext, {
  headers => { 'Content-type' => 'text/xml' }
});

die "Failed!\n" unless $response->{success};


print "$response->{status} $response->{reason}\n";

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?compara=plants"

r = requests.get(server+ext, headers={ "Content-Type" : "text/xml"})

if not r.ok:
  r.raise_for_status()
  sys.exit()


print r.text

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?compara=plants"

r = requests.get(server+ext, headers={ "Content-Type" : "text/xml"})

if not r.ok:
  r.raise_for_status()
  sys.exit()


print r.text

require 'net/http'
require 'uri'

server='http://test.rest.ensemblgenomes.org'
path = '/homology/id/AT3G52430?compara=plants'

url = URI.parse(server)
http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(path, {'Content-Type' => 'text/xml'})

response = http.request(request)

if response.code != "200"
  puts "Invalid response: #{response.code}"
  puts response.body
  exit
end


puts response.body

import java.net.URL;
import java.net.URLConnection;
import java.net.HttpURLConnection;
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.IOException;
import java.io.Reader;


public class EnsemblRest {

  public static void main(String[] args) throws Exception {
    String server = "http://test.rest.ensemblgenomes.org";
    String ext = "/homology/id/AT3G52430?compara=plants";
    URL url = new URL(server + ext);

    URLConnection connection = url.openConnection();
    HttpURLConnection httpConnection = (HttpURLConnection)connection;
    
    httpConnection.setRequestProperty("Content-Type", "text/xml");
    

    InputStream response = connection.getInputStream();
    int responseCode = httpConnection.getResponseCode();

    if(responseCode != 200) {
      throw new RuntimeException("Response code was not 200. Detected response was "+responseCode);
    }

    String output;
    Reader reader = null;
    try {
      reader = new BufferedReader(new InputStreamReader(response, "UTF-8"));
      StringBuilder builder = new StringBuilder();
      char[] buffer = new char[8192];
      int read;
      while ((read = reader.read(buffer, 0, buffer.length)) > 0) {
        builder.append(buffer, 0, read);
      }
      output = builder.toString();
    } 
    finally {
        if (reader != null) try {
          reader.close(); 
        } catch (IOException logOrIgnore) {
          logOrIgnore.printStackTrace();
        }
    }

    System.out.println(output);
  }
}


curl 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?compara=plants' -H 'Content-type:text/xml'

wget -q --header='Content-type:text/xml' 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?compara=plants'  -O -

/homology/id/AT3G52430?target_taxon=81972;content-type=application/json;sequence=cdna;target_species=arabidopsis lyrata;type=orthologues


use strict;
use warnings;

use HTTP::Tiny;

my $http = HTTP::Tiny->new();

my $server = 'http://test.rest.ensemblgenomes.org';
my $ext = '/homology/id/AT3G52430?target_taxon=81972;sequence=cdna;target_species=arabidopsis%20lyrata;type=orthologues';
my $response = $http->get($server.$ext, {
  headers => { 'Content-type' => 'application/json' }
});

die "Failed!\n" unless $response->{success};


use JSON;
use Data::Dumper;
if(length $response->{content}) {
  my $hash = decode_json($response->{content});
  local $Data::Dumper::Terse = 1;
  local $Data::Dumper::Indent = 1;
  print Dumper $hash;
  print "\n";
}

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?target_taxon=81972;sequence=cdna;target_species=arabidopsis lyrata;type=orthologues"

r = requests.get(server+ext, headers={ "Content-Type" : "application/json"})

if not r.ok:
  r.raise_for_status()
  sys.exit()

decoded = r.json()
print repr(decoded)

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?target_taxon=81972;sequence=cdna;target_species=arabidopsis lyrata;type=orthologues"

r = requests.get(server+ext, headers={ "Content-Type" : "application/json"})

if not r.ok:
  r.raise_for_status()
  sys.exit()

decoded = r.json()
print(repr(decoded))

require 'net/http'
require 'uri'

server='http://test.rest.ensemblgenomes.org'
path = '/homology/id/AT3G52430?target_taxon=81972;sequence=cdna;target_species=arabidopsis%20lyrata;type=orthologues'

url = URI.parse(server)
http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(path, {'Content-Type' => 'application/json'})

response = http.request(request)

if response.code != "200"
  puts "Invalid response: #{response.code}"
  puts response.body
  exit
end


require 'rubygems'
require 'json'
require 'yaml'

result = JSON.parse(response.body)
puts YAML::dump(result)

import java.net.URL;
import java.net.URLConnection;
import java.net.HttpURLConnection;
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.IOException;
import java.io.Reader;


public class EnsemblRest {

  public static void main(String[] args) throws Exception {
    String server = "http://test.rest.ensemblgenomes.org";
    String ext = "/homology/id/AT3G52430?target_taxon=81972;sequence=cdna;target_species=arabidopsis%20lyrata;type=orthologues";
    URL url = new URL(server + ext);

    URLConnection connection = url.openConnection();
    HttpURLConnection httpConnection = (HttpURLConnection)connection;
    
    httpConnection.setRequestProperty("Content-Type", "application/json");
    

    InputStream response = connection.getInputStream();
    int responseCode = httpConnection.getResponseCode();

    if(responseCode != 200) {
      throw new RuntimeException("Response code was not 200. Detected response was "+responseCode);
    }

    String output;
    Reader reader = null;
    try {
      reader = new BufferedReader(new InputStreamReader(response, "UTF-8"));
      StringBuilder builder = new StringBuilder();
      char[] buffer = new char[8192];
      int read;
      while ((read = reader.read(buffer, 0, buffer.length)) > 0) {
        builder.append(buffer, 0, read);
      }
      output = builder.toString();
    } 
    finally {
        if (reader != null) try {
          reader.close(); 
        } catch (IOException logOrIgnore) {
          logOrIgnore.printStackTrace();
        }
    }

    System.out.println(output);
  }
}


curl 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?target_taxon=81972;sequence=cdna;target_species=arabidopsis%20lyrata;type=orthologues' -H 'Content-type:application/json'

wget -q --header='Content-type:application/json' 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?target_taxon=81972;sequence=cdna;target_species=arabidopsis lyrata;type=orthologues'  -O -

/homology/id/AT3G52430?content-type=text/xml;format=condensed;type=orthologues


use strict;
use warnings;

use HTTP::Tiny;

my $http = HTTP::Tiny->new();

my $server = 'http://test.rest.ensemblgenomes.org';
my $ext = '/homology/id/AT3G52430?format=condensed;type=orthologues';
my $response = $http->get($server.$ext, {
  headers => { 'Content-type' => 'text/xml' }
});

die "Failed!\n" unless $response->{success};


print "$response->{status} $response->{reason}\n";

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?format=condensed;type=orthologues"

r = requests.get(server+ext, headers={ "Content-Type" : "text/xml"})

if not r.ok:
  r.raise_for_status()
  sys.exit()


print r.text

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?format=condensed;type=orthologues"

r = requests.get(server+ext, headers={ "Content-Type" : "text/xml"})

if not r.ok:
  r.raise_for_status()
  sys.exit()


print r.text

require 'net/http'
require 'uri'

server='http://test.rest.ensemblgenomes.org'
path = '/homology/id/AT3G52430?format=condensed;type=orthologues'

url = URI.parse(server)
http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(path, {'Content-Type' => 'text/xml'})

response = http.request(request)

if response.code != "200"
  puts "Invalid response: #{response.code}"
  puts response.body
  exit
end


puts response.body

import java.net.URL;
import java.net.URLConnection;
import java.net.HttpURLConnection;
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.IOException;
import java.io.Reader;


public class EnsemblRest {

  public static void main(String[] args) throws Exception {
    String server = "http://test.rest.ensemblgenomes.org";
    String ext = "/homology/id/AT3G52430?format=condensed;type=orthologues";
    URL url = new URL(server + ext);

    URLConnection connection = url.openConnection();
    HttpURLConnection httpConnection = (HttpURLConnection)connection;
    
    httpConnection.setRequestProperty("Content-Type", "text/xml");
    

    InputStream response = connection.getInputStream();
    int responseCode = httpConnection.getResponseCode();

    if(responseCode != 200) {
      throw new RuntimeException("Response code was not 200. Detected response was "+responseCode);
    }

    String output;
    Reader reader = null;
    try {
      reader = new BufferedReader(new InputStreamReader(response, "UTF-8"));
      StringBuilder builder = new StringBuilder();
      char[] buffer = new char[8192];
      int read;
      while ((read = reader.read(buffer, 0, buffer.length)) > 0) {
        builder.append(buffer, 0, read);
      }
      output = builder.toString();
    } 
    finally {
        if (reader != null) try {
          reader.close(); 
        } catch (IOException logOrIgnore) {
          logOrIgnore.printStackTrace();
        }
    }

    System.out.println(output);
  }
}


curl 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?format=condensed;type=orthologues' -H 'Content-type:text/xml'

wget -q --header='Content-type:text/xml' 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?format=condensed;type=orthologues'  -O -

/homology/id/AT3G52430?content-type=text/x-orthoxml%2Bxml


use strict;
use warnings;

use HTTP::Tiny;

my $http = HTTP::Tiny->new();

my $server = 'http://test.rest.ensemblgenomes.org';
my $ext = '/homology/id/AT3G52430?';
my $response = $http->get($server.$ext, {
  headers => { 'Content-type' => 'text/x-orthoxml+xml' }
});

die "Failed!\n" unless $response->{success};


print "$response->{status} $response->{reason}\n";

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?"

r = requests.get(server+ext, headers={ "Content-Type" : "text/x-orthoxml+xml"})

if not r.ok:
  r.raise_for_status()
  sys.exit()


print r.text

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?"

r = requests.get(server+ext, headers={ "Content-Type" : "text/x-orthoxml+xml"})

if not r.ok:
  r.raise_for_status()
  sys.exit()


print r.text

require 'net/http'
require 'uri'

server='http://test.rest.ensemblgenomes.org'
path = '/homology/id/AT3G52430?'

url = URI.parse(server)
http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(path, {'Content-Type' => 'text/x-orthoxml+xml'})

response = http.request(request)

if response.code != "200"
  puts "Invalid response: #{response.code}"
  puts response.body
  exit
end


puts response.body

import java.net.URL;
import java.net.URLConnection;
import java.net.HttpURLConnection;
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.IOException;
import java.io.Reader;


public class EnsemblRest {

  public static void main(String[] args) throws Exception {
    String server = "http://test.rest.ensemblgenomes.org";
    String ext = "/homology/id/AT3G52430?";
    URL url = new URL(server + ext);

    URLConnection connection = url.openConnection();
    HttpURLConnection httpConnection = (HttpURLConnection)connection;
    
    httpConnection.setRequestProperty("Content-Type", "text/x-orthoxml+xml");
    

    InputStream response = connection.getInputStream();
    int responseCode = httpConnection.getResponseCode();

    if(responseCode != 200) {
      throw new RuntimeException("Response code was not 200. Detected response was "+responseCode);
    }

    String output;
    Reader reader = null;
    try {
      reader = new BufferedReader(new InputStreamReader(response, "UTF-8"));
      StringBuilder builder = new StringBuilder();
      char[] buffer = new char[8192];
      int read;
      while ((read = reader.read(buffer, 0, buffer.length)) > 0) {
        builder.append(buffer, 0, read);
      }
      output = builder.toString();
    } 
    finally {
        if (reader != null) try {
          reader.close(); 
        } catch (IOException logOrIgnore) {
          logOrIgnore.printStackTrace();
        }
    }

    System.out.println(output);
  }
}


curl 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?' -H 'Content-type:text/x-orthoxml+xml'

wget -q --header='Content-type:text/x-orthoxml+xml' 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?'  -O -

/homology/id/AT3G52430?target_taxon=81972;content-type=text/x-orthoxml%2Bxml;type=orthologues


use strict;
use warnings;

use HTTP::Tiny;

my $http = HTTP::Tiny->new();

my $server = 'http://test.rest.ensemblgenomes.org';
my $ext = '/homology/id/AT3G52430?target_taxon=81972;type=orthologues';
my $response = $http->get($server.$ext, {
  headers => { 'Content-type' => 'text/x-orthoxml+xml' }
});

die "Failed!\n" unless $response->{success};


print "$response->{status} $response->{reason}\n";

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?target_taxon=81972;type=orthologues"

r = requests.get(server+ext, headers={ "Content-Type" : "text/x-orthoxml+xml"})

if not r.ok:
  r.raise_for_status()
  sys.exit()


print r.text

import requests, sys

server = "http://test.rest.ensemblgenomes.org"
ext = "/homology/id/AT3G52430?target_taxon=81972;type=orthologues"

r = requests.get(server+ext, headers={ "Content-Type" : "text/x-orthoxml+xml"})

if not r.ok:
  r.raise_for_status()
  sys.exit()


print r.text

require 'net/http'
require 'uri'

server='http://test.rest.ensemblgenomes.org'
path = '/homology/id/AT3G52430?target_taxon=81972;type=orthologues'

url = URI.parse(server)
http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(path, {'Content-Type' => 'text/x-orthoxml+xml'})

response = http.request(request)

if response.code != "200"
  puts "Invalid response: #{response.code}"
  puts response.body
  exit
end


puts response.body

import java.net.URL;
import java.net.URLConnection;
import java.net.HttpURLConnection;
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.IOException;
import java.io.Reader;


public class EnsemblRest {

  public static void main(String[] args) throws Exception {
    String server = "http://test.rest.ensemblgenomes.org";
    String ext = "/homology/id/AT3G52430?target_taxon=81972;type=orthologues";
    URL url = new URL(server + ext);

    URLConnection connection = url.openConnection();
    HttpURLConnection httpConnection = (HttpURLConnection)connection;
    
    httpConnection.setRequestProperty("Content-Type", "text/x-orthoxml+xml");
    

    InputStream response = connection.getInputStream();
    int responseCode = httpConnection.getResponseCode();

    if(responseCode != 200) {
      throw new RuntimeException("Response code was not 200. Detected response was "+responseCode);
    }

    String output;
    Reader reader = null;
    try {
      reader = new BufferedReader(new InputStreamReader(response, "UTF-8"));
      StringBuilder builder = new StringBuilder();
      char[] buffer = new char[8192];
      int read;
      while ((read = reader.read(buffer, 0, buffer.length)) > 0) {
        builder.append(buffer, 0, read);
      }
      output = builder.toString();
    } 
    finally {
        if (reader != null) try {
          reader.close(); 
        } catch (IOException logOrIgnore) {
          logOrIgnore.printStackTrace();
        }
    }

    System.out.println(output);
  }
}


curl 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?target_taxon=81972;type=orthologues' -H 'Content-type:text/x-orthoxml+xml'

wget -q --header='Content-type:text/x-orthoxml+xml' 'http://test.rest.ensemblgenomes.org/homology/id/AT3G52430?target_taxon=81972;type=orthologues'  -O -

Resource Information

MethodsGET
Response formatsjson
xml
orthoxml
jsonp