{"note":"OpenAPI conversion -- returning structured metadata","name":"warwick-ac-uk-enterobase","description":"Enterobase-API","version":"v2.0","base_url":"","endpoints":30,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Enterobase-API\n@version v2.0\n@auth basic\n@endpoints 30\n@hint download_for_search\n@toc api(30)\n\n@endpoint GET /api/v2.0\n@desc Top level information about EnteroBase databases\n@optional {description: any # Database description, prefix: any # Database prefix, e.g. SAL for Salmonella, name: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\n@returns(200) A info object\n@errors {403: Unauthorised access for this specific resource or data}\n\n@endpoint GET /api/v2.0/login\n@desc Login endpoint, refresh your API token\n@optional {password: any # EnteroBase Password, username: any # EnteroBase username}\n@returns(200) A login object\n@errors {403: Unauthorised access for this specific resource or data}\n\n@endpoint GET /api/v2.0/lookup\n@desc Generic endpoint for lookup list of barcodes\n@optional {barcode: any # Unique barcode for records, __ e.g. SAL_AA0001AA_ST for a trace record}\n@returns(200) List of lookup objects\n@errors {403: Unauthorised access for this specific resource or data, 408: Connection timeout, please try again later.}\n\n@endpoint GET /api/v2.0/lookup/{barcode}\n@desc Generic endpoint for lookup of barcodes\n@required {barcode: any # Unique barcode for records, __ e.g. SAL_AA0001AA_ST for a trace record}\n@returns(200) A lookup object\n@errors {403: Unauthorised access for this specific resource or data}\n\n@endpoint POST /api/v2.0/lookup/{barcode}\n@desc Generic endpoint for lookup of barcodes\n@required {barcode: any # Unique barcode for records, __ e.g. SAL_AA0001AA_ST for a trace record}\n@optional {body: map}\n@returns(200) A lookup object\n@errors {403: Unauthorised access for this specific resource or data}\n\n@endpoint GET /api/v2.0/{database}/AMRdata\n@desc AMR data\n@required {database: any # Species database name e.g. senterica, ecoli, yersinia, mcatarrhalis}\n@optional {offset: any # Cursor position in results, barcode: any # One or more barcodes for assemblies associated with AMR data records, e.g. SAL_AA0001AA_AS, only_fields: any, orderby: any # Field to order by. Default: barcode, limit: any # Number of results per page, sortorder: any # Order of search results: asc or desc}\n@returns(200) List of AMRdata objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/AMRdata/{barcode}\n@desc AMR data\n@required {database: any # Species database name e.g. senterica, ecoli, yersinia, mcatarrhalis, barcode: any # One or more barcodes for assemblies associated with AMR data records, e.g. SAL_AA0001AA_AS}\n@optional {body: map}\n@returns(200) List of AMRdata objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint POST /api/v2.0/{database}/AMRdata/{barcode}\n@desc AMR data\n@required {database: any # Species database name e.g. senterica, ecoli, yersinia, mcatarrhalis, barcode: any # One or more barcodes for assemblies associated with AMR data records, e.g. SAL_AA0001AA_AS}\n@optional {body: map}\n@returns(200) List of AMRdata objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint PUT /api/v2.0/{database}/AMRdata/{barcode}\n@desc AMR data\n@required {database: any # Species database name e.g. senterica, ecoli, yersinia, mcatarrhalis, barcode: any # One or more barcodes for assemblies associated with AMR data records, e.g. SAL_AA0001AA_AS}\n@optional {body: map}\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/assemblies\n@desc Genome assemblies\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\n@optional {offset: any # Cursor position in results, barcode: any # Unique barcode for Assembly records, __AS e.g. SAL_AA0001AA_AS, uberstrain: any, only_fields: any, orderby: any # Field to order by. Default: barcode, limit: any # Number of results per page, n50: any, version: any, top_species: any, assembly_status: any, reldate: any, sortorder: any # Order of search results: asc or desc}\n@returns(200) List of assemblies objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/assemblies/{barcode}\n@desc Genome assemblies\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Assembly records, __AS e.g. SAL_AA0001AA_AS}\n@optional {body: map}\n@returns(200) List of assemblies objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint POST /api/v2.0/{database}/assemblies/{barcode}\n@desc Genome assemblies\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Assembly records, __AS e.g. SAL_AA0001AA_AS}\n@optional {body: map}\n@returns(200) List of assemblies objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint PUT /api/v2.0/{database}/assemblies/{barcode}\n@desc Genome assemblies\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Assembly records, __AS e.g. SAL_AA0001AA_AS}\n@optional {body: map}\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/schemes\n@desc Genotyping schemes\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\n@optional {offset: any # Cursor position in results, lastmodified: any, barcode: any # Unique barcode for Scheme records, e.g. SAW_AA0002AA_SC, only_fields: any, orderby: any # Field to order by. Default: barcode, scheme_name: any # Name of scheme, e.g. cgMLST_v2, limit: any # Number of results per page, label: any, version: any, created: any, sortorder: any # Order of search results: asc or desc}\n@returns(200) List of schemes objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/schemes/{barcode}\n@desc Genotyping schemes\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Scheme records, e.g. SAW_AA0002AA_SC}\n@optional {body: map}\n@returns(200) List of schemes objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint POST /api/v2.0/{database}/schemes/{barcode}\n@desc Genotyping schemes\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Scheme records, e.g. SAW_AA0002AA_SC}\n@optional {body: map}\n@returns(200) List of schemes objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint PUT /api/v2.0/{database}/schemes/{barcode}\n@desc Genotyping schemes\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Scheme records, e.g. SAW_AA0002AA_SC}\n@optional {body: map}\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/straindata\n@desc Strain data\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\n@optional {sample_accession: any, collection_month: any, collection_time: any, continent: any, orderby: any # Field to order by. Default: barcode, strain_name: any, top_species: any, reldate: any, lab_contact: any, substrains: any, county: any, collection_year: any, country: any, uberstrain: any, latitude: any, email: any, my_strains: any, n50: any, region: any, source_type: any, offset: any # Cursor position in results, barcode: any # Unique barcode for Strain record, _ e.g. SAL_AA0001AA, postcode: any, serotype: any, version: any, comment: any, assembly_status: any, collection_date: any, sortorder: any # Order of search results: asc or desc, only_fields: any, source_details: any, secondary_sample_accession: any, longitude: any, limit: any # Number of results per page, city: any, custom_fields: any, source_niche: any}\n@returns(200) List of straindata objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/strains\n@desc Strain metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\n@optional {sample_accession: any, collection_month: any, collection_time: any, continent: any, orderby: any # Field to order by. Default: barcode, strain_name: any, antigenic_formulas: any, reldate: any, lab_contact: any, substrains: any, county: any, collection_year: any, country: any, uberstrain: any, latitude: any, my_strains: any, region: any, return_all: any, source_type: any, offset: any # Cursor position in results, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, postcode: any, assembly_barcode: any, serotype: any, version: any, comment: any, collection_date: any, sortorder: any # Order of search results: asc or desc, only_fields: any, source_details: any, secondary_sample_accession: any, longitude: any, limit: any # Number of results per page, city: any, source_niche: any}\n@returns(200) List of strains objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/strains/{barcode}\n@desc Strain metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA}\n@optional {body: map}\n@returns(200) List of strains objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint POST /api/v2.0/{database}/strains/{barcode}\n@desc Strain metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA}\n@optional {body: map}\n@returns(200) List of strains objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint PUT /api/v2.0/{database}/strains/{barcode}\n@desc Strain metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA}\n@optional {body: map}\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/strainsversion\n@desc Strain previous metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\n@optional {sample_accession: any, collection_month: any, collection_time: any, continent: any, orderby: any # Field to order by. Default: barcode, strain_name: any, antigenic_formulas: any, reldate: any, lab_contact: any, substrains: any, county: any, collection_year: any, country: any, uberstrain: any, latitude: any, my_strains: any, region: any, return_all: any, source_type: any, offset: any # Cursor position in results, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, postcode: any, assembly_barcode: any, serotype: any, version: any, comment: any, collection_date: any, sortorder: any # Order of search results: asc or desc, only_fields: any, source_details: any, secondary_sample_accession: any, longitude: any, limit: any # Number of results per page, city: any, source_niche: any}\n@returns(200) List of strainsversion objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/traces\n@desc Traces (sequence-reads) metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\n@optional {offset: any # Cursor position in results, barcode: any # Unique barcode for Traces records, __TR e.g. SAL_AA0001AA_TR, only_fields: any, orderby: any # Field to order by. Default: barcode, limit: any # Number of results per page, sortorder: any # Order of search results: asc or desc}\n@returns(200) List of traces objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/traces/{barcode}\n@desc Traces (sequence-reads) metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Traces records, __TR e.g. SAL_AA0001AA_TR}\n@optional {body: map}\n@returns(200) List of traces objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint POST /api/v2.0/{database}/traces/{barcode}\n@desc Traces (sequence-reads) metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Traces records, __TR e.g. SAL_AA0001AA_TR}\n@optional {body: map}\n@returns(200) List of traces objects\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint PUT /api/v2.0/{database}/traces/{barcode}\n@desc Traces (sequence-reads) metadata\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, barcode: any # Unique barcode for Traces records, __TR e.g. SAL_AA0001AA_TR}\n@optional {body: map}\n@errors {403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/{scheme}/alleles\n@desc Alleles  data\n@required {locus: any, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, scheme: any}\n@optional {offset: any, seq: any, allele_id: any, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, only_fields: any, limit: any, reldate: any}\n@returns(200) List of alleles objects\n@errors {400: Malformed request, contains an error, 403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/{scheme}/loci\n@desc Loci\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, scheme: any}\n@optional {offset: any, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, scheme: any, only_fields: any, locus: any, limit: any, create_time: any}\n@returns(200) List of loci objects\n@errors {400: Malformed request, contains an error, 403: Unauthorised access for this specific resource}\n\n@endpoint GET /api/v2.0/{database}/{scheme}/sts\n@desc ST profile data\n@required {database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, scheme: any # Name of scheme, e.g. cgMLST_v2}\n@optional {offset: any # Cursor position in results, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, reldate: any, scheme: any # Name of scheme, e.g. cgMLST_v2, only_fields: any, st_id: any # One or more comma separated ST numbers, suggest limit to a maximum of 500, show_alleles: any, limit: any # Number of results per response - suggested maximum 500}\n@returns(200) List of sts objects\n@errors {400: Malformed request, contains an error, 403: Unauthorised access for this specific resource}\n\n@end\n"}