{"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 {prefix: any # Database prefix, e.g. SAL for Salmonella, name: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively, description: any # Database description}\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 {barcode: any # One or more barcodes for assemblies associated with AMR data records, e.g. SAL_AA0001AA_AS, only_fields: any, limit: any # Number of results per page, sortorder: any # Order of search results: asc or desc, offset: any # Cursor position in results, orderby: any # Field to order by. Default: barcode}\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 {barcode: any # One or more barcodes for assemblies associated with AMR data records, e.g. SAL_AA0001AA_AS, database: any # Species database name e.g. senterica, ecoli, yersinia, mcatarrhalis}\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 {barcode: any # One or more barcodes for assemblies associated with AMR data records, e.g. SAL_AA0001AA_AS, database: any # Species database name e.g. senterica, ecoli, yersinia, mcatarrhalis}\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 {barcode: any # One or more barcodes for assemblies associated with AMR data records, e.g. SAL_AA0001AA_AS, database: any # Species database name e.g. senterica, ecoli, yersinia, mcatarrhalis}\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 {barcode: any # Unique barcode for Assembly records, __AS e.g. SAL_AA0001AA_AS, assembly_status: any, only_fields: any, uberstrain: any, n50: any, reldate: any, top_species: any, limit: any # Number of results per page, version: any, sortorder: any # Order of search results: asc or desc, offset: any # Cursor position in results, orderby: any # Field to order by. Default: barcode}\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 {barcode: any # Unique barcode for Assembly records, __AS e.g. SAL_AA0001AA_AS, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {barcode: any # Unique barcode for Assembly records, __AS e.g. SAL_AA0001AA_AS, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {barcode: any # Unique barcode for Assembly records, __AS e.g. SAL_AA0001AA_AS, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {lastmodified: any, created: any, label: any, barcode: any # Unique barcode for Scheme records, e.g. SAW_AA0002AA_SC, scheme_name: any # Name of scheme, e.g. cgMLST_v2, only_fields: any, limit: any # Number of results per page, version: any, sortorder: any # Order of search results: asc or desc, offset: any # Cursor position in results, orderby: any # Field to order by. Default: barcode}\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 {barcode: any # Unique barcode for Scheme records, e.g. SAW_AA0002AA_SC, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {barcode: any # Unique barcode for Scheme records, e.g. SAW_AA0002AA_SC, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {barcode: any # Unique barcode for Scheme records, e.g. SAW_AA0002AA_SC, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {serotype: any, version: any, barcode: any # Unique barcode for Strain record, _ e.g. SAL_AA0001AA, source_niche: any, source_details: any, substrains: any, source_type: any, county: any, email: any, postcode: any, my_strains: any, continent: any, orderby: any # Field to order by. Default: barcode, custom_fields: any, latitude: any, assembly_status: any, n50: any, limit: any # Number of results per page, comment: any, strain_name: any, offset: any # Cursor position in results, region: any, city: any, secondary_sample_accession: any, collection_year: any, collection_time: any, reldate: any, collection_date: any, top_species: any, country: any, uberstrain: any, only_fields: any, sample_accession: any, longitude: any, collection_month: any, lab_contact: any, sortorder: any # Order of search results: asc or desc}\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 {serotype: any, version: any, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, source_niche: any, source_details: any, lab_contact: any, substrains: any, source_type: any, county: any, antigenic_formulas: any, postcode: any, my_strains: any, continent: any, orderby: any # Field to order by. Default: barcode, return_all: any, latitude: any, limit: any # Number of results per page, assembly_barcode: any, comment: any, strain_name: any, offset: any # Cursor position in results, region: any, city: any, collection_year: any, secondary_sample_accession: any, collection_time: any, reldate: any, country: any, uberstrain: any, only_fields: any, sample_accession: any, longitude: any, collection_month: any, collection_date: any, sortorder: any # Order of search results: asc or desc}\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 {barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {serotype: any, version: any, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, source_niche: any, source_details: any, lab_contact: any, substrains: any, source_type: any, county: any, antigenic_formulas: any, postcode: any, my_strains: any, continent: any, orderby: any # Field to order by. Default: barcode, return_all: any, latitude: any, limit: any # Number of results per page, assembly_barcode: any, comment: any, strain_name: any, offset: any # Cursor position in results, region: any, city: any, collection_year: any, secondary_sample_accession: any, collection_time: any, reldate: any, country: any, uberstrain: any, only_fields: any, sample_accession: any, longitude: any, collection_month: any, collection_date: any, sortorder: any # Order of search results: asc or desc}\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 {barcode: any # Unique barcode for Traces records, __TR e.g. SAL_AA0001AA_TR, only_fields: any, limit: any # Number of results per page, sortorder: any # Order of search results: asc or desc, offset: any # Cursor position in results, orderby: any # Field to order by. Default: barcode}\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 {barcode: any # Unique barcode for Traces records, __TR e.g. SAL_AA0001AA_TR, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {barcode: any # Unique barcode for Traces records, __TR e.g. SAL_AA0001AA_TR, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {barcode: any # Unique barcode for Traces records, __TR e.g. SAL_AA0001AA_TR, database: any # Species database name (senterica, ecoli, yersinia, mcatarrhalis) for Salmonella, Escherichia, Yersinia, Moraxella respectively}\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 {seq: any, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, only_fields: any, allele_id: any, reldate: any, limit: any, offset: 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 {scheme: any, create_time: any, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, only_fields: any, locus: any, limit: any, offset: 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 {scheme: any # Name of scheme, e.g. cgMLST_v2, show_alleles: any, st_id: any # One or more comma separated ST numbers, suggest limit to a maximum of 500, barcode: any # Unique barcode for Strain records, _ e.g. SAL_AA0001AA, only_fields: any, reldate: any, limit: any # Number of results per response - suggested maximum 500, offset: any # Cursor position in results}\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"}