3.2 Calls

Calls to the API can be performed using either GET or POST methods.
However, if your request involves file uploads, you will be enforced to use the POST method.

Submitting a cross-match job

Compulsory parameters

If cat1 is an uploaded table or a pointer to a URL, the following parameters are also compulsory:

If cat2 is an uploaded table or a pointer to a URL, the following parameters are also compulsory:

Optional parameters

Have a look at section 3.7 for some typical usage examples.

Retrieving the available VizieR tables

To get the list of the VizieR tables which are available in the service, make a call to:

http://cdsxmatch.u-strasbg.fr/xmatch/api/v1/sync/tables?
action=getVizieRTableNames&RESPONSEFORMAT=txt

You can also get back this list formatted as a JSON document:

http://cdsxmatch.u-strasbg.fr/xmatch/api/v1/sync/tables?
action=getVizieRTableNames&RESPONSEFORMAT=json

Optionally you can ask for all tables (default) or only large, notlarge, medium or small tables using option select. Example:

http://cdsxmatch.u-strasbg.fr/xmatch/api/v1/sync/tables?
action=getVizieRTableNames&select=large&RESPONSEFORMAT=json

You can then retrieve more information about a specific table:

http://cdsxmatch.u-strasbg.fr/xmatch/api/v1/sync/tables?
action=getInfo&tabName=TABLENAME

And the list of its columns:

http://cdsxmatch.u-strasbg.fr/xmatch/api/v1/sync/tables?
action=getColList&tabName=TABLENAME&RESPONSEFORMAT=votable|json|csv|tsv|txt

You can also directly download the information of all tables with one call to:

http://cdsxmatch.u-strasbg.fr/xmatch/api/v1/sync/tables

Finally, you can also call:

http://cdsxmatch.u-strasbg.fr/xmatch/api/v1/sync/tables?action=getPrettyNames
http://cdsxmatch.u-strasbg.fr/xmatch/api/v1/sync/tables?action=getAliases

© UDS/CNRS

Contact