BLbluestaq
Star Catalog

GET /udl/starcatalog

Changed on

Service operation to dynamically query data by a variety of query parameters not specified in this API documentation. See the queryhelp operation (/udl/<datatype>/queryhelp) for more details on valid/required query parameter information.

Request

  • Base URL
    https://unifieddatalibrary.com
  • URL
    https://unifieddatalibrary.com/udl/starcatalog
  • Auth
    none declared

Query parameters

decnumber double

(One or more of fields 'dec, ra' are required.) Barycentric declination of the source in International Celestial Reference System (ICRS) at the reference epoch, in degrees.

ranumber double

(One or more of fields 'dec, ra' are required.) Barycentric right ascension of the source in the International Celestial Reference System (ICRS) frame at the reference epoch, in degrees.

firstResultinteger
maxResultsinteger

Response

OK

idstring

Unique identifier of the record, auto-generated by the system.

classificationMarkingstring required

Classification marking of the data in IC/CAPCO Portion-marked format.

csIdinteger required

The ID of this object in the specific catalog associated with this record. This field will either contain the value in the gncCatId or sdaCatId field.

gncCatIdinteger

The ID of this object in the Guidance and Navigation Control (GNC) Catalog. If this field is populated it shall match the csId field.

sdaCatIdinteger

The ID of this object in the Space Domain Awareness (SDA) Catalog. If this field is populated it shall match the csId field.

gaiadr3CatIdinteger

The source ID of this object in the Gaia DR3 Catalog (GA).

hipCatIdinteger

The HIP ID of this object in the Hipparcos Catalog (HI).

twoMASSIdstring

The designation of this object in the Two Micron All Sky Survey (2MASS) Point Source Catalog (TP).

allWISEIdstring

The designation of this object in the All Wide-field Infrared Survey Explorer (AllWISE) catalog (AL).

panStarrsIdinteger

The Panoramic Survey Telescope and Rapid Response System (Pan-STARRS) (PS) object ID.

ukidssLASIdinteger

The United Kingdom Infrared Deep Sky Survey (UKIDSS) Large Area Survey (LAS) (UL) source ID of this object.

vhsIdinteger

The Visible and Infrared Survey Telescope for Astronomy (VISTA) Hemisphere Survey (VHS) (VS) source ID of this object.

aavsoVsxIdinteger

The American Association of Variable Star Observers (AAVSO) Variable Star Index (VSX) (VX) object ID of this object.

tychoDscIdinteger

The Tycho Double Star Catalog (TD) identifier (specified as Tycho-2 ID) of this object.

twoMassXscIdstring

The Two Micron All Sky Survey (2MASS) Extended Source Catalog (XSC) (TX) designation of this object.

ukidssGPSIdinteger

The United Kingdom Infrared Deep Sky Survey (UKIDSS) Galactic Plane Survey (GPS) (UP) source ID of this object.

wdsCatIdstring

The Washington Double Star Catalog (WD) identifier of this object.

carrascoCatIdinteger

The Carrasco catalog (CR) identifier of this object.

ducatiCatIdstring

The Ducati catalog (DU) name of this object.

apassIdstring

The American Association of Variable Star Observers (AAVSO) Photometric All-Sky Survey (APASS) (AP) name of this object.

skyMapperIdinteger

The SkyMapper (SK) catalog object ID.

uhsIdinteger

The United Kingdom Infrared Telescope (UKIRT) Hemispheric Survey (UHS) (UH) source ID of this object.

catWise2020Idstring

The CatWISE2020 (CA) catalog source ID of this object.

ukidssGCSIdinteger

The United Kingdom Infrared Deep Sky Survey (UKIDSS) Galactic Clusters Survey (GCS) (UC) source ID of this object.

healpixIndexinteger

The Healpix index. Consumers should contact the provider for details on the indexing scheme.

catVersionstring

The version of the catalog associated with this object.

ranumber double required

Barycentric right ascension of the source in the International Celestial Reference System (ICRS) frame at the reference epoch, in degrees.

raUncnumber double

Uncertainty of the right ascension of the source, in milliarcseconds, at the reference epoch.

decnumber double required

Barycentric declination of the source in International Celestial Reference System (ICRS) at the reference epoch, in degrees.

decUncnumber double

Uncertainty of the declination of the source, in milliarcseconds, at the reference epoch.

posUncFlagboolean

Flag indicating that the position uncertainty in either ra or dec is greater than 100 milliarcseconds.

parallaxnumber double

Absolute stellar parallax of the source, in milliarcseconds.

parallaxUncnumber double

Uncertainty of the stellar parallax, in milliarcseconds.

pmranumber double

Proper motion in right ascension of the source, in milliarcseconds per year, at the reference epoch.

pmraUncnumber double

Uncertainty of proper motion in right ascension, in milliarcseconds per year.

pmdecnumber double

Proper motion in declination of the source, in milliarcseconds per year, at the reference epoch.

pmdecUncnumber double

Uncertainty of proper motion in declination, in milliarcseconds per year.

pmUncFlagboolean

Flag indicating that the proper motion uncertainty in either ra or dec is greater than 10 milliarcseconds per year.

astrometryOriginstring required

Originating astrometric catalog for this object (GA (GAIA), HI (HIPPARCOS), UB (USNOBSC), AL, AP, CA, CR, DU, FK6_I, FK6_III, PS, SK, TD, TP, TX, UC, UL, UH, UP, VH, VS, WD).

starEpochnumber double required

Reference epoch to which the astrometric source parameters are referred, expressed as Julian Year in Barycentric Coordinate Time (TCB).

gmagnumber double

Gaia optical photometric G-band in the Vega scale measured in magnitudes.

gmagUncnumber double

Gaia optical photometric G-band uncertainty in the Vega scale measured in magnitudes.

bpmagnumber double

Gaia optical photometric Bp-band in the Vega scale measured in magnitudes.

bpmagUncnumber double

Gaia optical Bp-band uncertainty in the Vega scale measured in magnitudes.

rpmagnumber double

Gaia optical Rp-band in the Vega scale measured in magnitudes.

rpmagUncnumber double

Gaia optical photometric Rp-band uncertainty in the Vega scale measured in magnitudes.

sgmagnumber double

Original G magnitude if the source is in Gaia, otherwise the magnitude is converted from other photometric passbands, when possible, measured in magnitudes.

sgmagUncnumber double

Uncertainty of sgmag measured in magnitudes.

bmagnumber double

Optical Johnson B magnitude measured in magnitudes.

bmagUncnumber double

Uncertainty of optical Johnson B magnitude measured in magnitudes.

bmagOriginstring

Catalog of origin of optical Johnson B magnitude (AP, CR, HI).

vmagnumber double

Optical Johnson V magnitude measured in magnitudes.

vmagUncnumber double

Uncertainty of the Optical Johnson V magnitude measured in magnitudes.

vmagOriginstring

Catalog of origin of Optical Johnson V magnitude (AP, CR, DU, GA, HI).

rmagnumber double

Optical Johnson R magnitude measured in magnitudes.

rmagUncnumber double

Uncertainty of the Optical Johnson R magnitude measured in magnitudes.

rmagOriginstring

Catalog of origin of the Optical Johnson R magnitude (CR, GA).

imagnumber double

Optical Johnson I magnitude measured in magnitudes.

imagUncnumber double

Uncertainty of optical Johnson I magnitude measured in magnitudes.

imagOriginstring

Catalog of origin of optical Johnson I magnitude (CR, GA, HI).

abgmagnumber double

Optical AB g magnitude.

abgmagUncnumber double

Uncertainty of optical AB g magnitude.

abgmagOriginstring

Catalog of origin of optical AB g magnitude.

abrmagnumber double

Optical AB r magnitude.

abrmagUncnumber double

Uncertainty of optical AB r magnitude.

abrmagOriginstring

Catalog of origin of optical AB r magnitude.

abimagnumber double

Optical AB i magnitude.

abimagUncnumber double

Uncertainty of optical AB i magnitude.

abimagOriginstring

Catalog of origin of optical AB i magnitude.

abzmagnumber double

Optical AB z magnitude.

abzmagUncnumber double

Uncertainty of optical AB z magnitude.

abzmagOriginstring

Catalog of origin of optical AB z magnitude.

abymagnumber double

Optical AB y magnitude.

abymagUncnumber double

Uncertainty of optical AB y magnitude.

abymagOriginstring

Catalog of origin of optical AB y magnitude.

jmagnumber double

Near-infrared photometric J-band magnitude in the Vega scale measured in magnitudes.

jmagUncnumber double

Near-infrared photometric J-band magnitude uncertainty in the Vega scale measured in magnitudes.

jmagOriginstring

Near-infrared photometric J-band catalog of origin in the Vega scale (TP, UH, UL, UP, VH).

kmagnumber double

Near-infrared photometric K-band magnitude in the Vega scale measured in magnitudes.

kmagUncnumber double

Near-infrared photometric K-band magnitude uncertainty in the Vega scale measured in magnitudes.

kmagOriginstring

Near-infrared photometric K-band catalog of origin in the Vega scale (TP, UC, UH, UL, UP, VH).

hmagnumber double

Near-infrared photometric H-band magnitude in the Vega scale measured in magnitudes.

hmagUncnumber double

Near-infrared photometric H-band magnitude uncertainty in the Vega scale measured in magnitudes.

hmagOriginstring

Near-infrared photometric H-band catalog of origin in the Vega scale (TP, UC, UL, UP, VH).

w1magnumber double

Mid-infrared photometric W1-band (3.4 microns) magnitude in the Vega system measured in magnitudes.

w1magUncnumber double

Mid-infrared photometric W1-band (3.4 microns) magnitude uncertainty in the Vega system measured in magnitudes.

w1satnumber double

Mid-infrared photometric W1-band (3.4 microns) saturated pixel fraction in the Vega system.

w1magOriginstring

Mid-infrared photometric W1-band (3.4 microns) catalog of origin in the Vega system (AL, CA).

w2magnumber double

Mid-infrared photometric W2-band (4.6 microns) magnitude in the Vega system measured in magnitudes.

w2magUncnumber double

Mid-infrared photometric W2-band (4.6 microns) magnitude uncertainty in the Vega system measured in magnitudes.

w2satnumber double

Mid-infrared photometric W2-band (4.6 microns) saturated pixel fraction in the Vega system.

w2magOriginstring

Mid-infrared photometric W2-band (4.6 microns) catalog of origin in the Vega system (AL, CA).

w3magnumber double

Mid-infrared photometric W3-band (12 microns) magnitude in the Vega system measured in magnitudes.

w3magUncnumber double

Mid-infrared photometric W3-band (12 microns) magnitude uncertainty in the Vega system measured in magnitudes.

w3satnumber double

Mid-infrared photometric W3-band (12 microns) saturated pixel fraction in the Vega system.

w3magOriginstring

Mid-infrared photometric W3-band (12 microns) catalog of origin in the Vega system (AL).

w4magnumber double

Mid-infrared photometric W4-band (22 microns) magnitude in the Vega system measured in magnitudes.

w4magUncnumber double

Mid-infrared photometric W4-band (22 microns) magnitude uncertainty in the Vega system measured in magnitudes.

w4satnumber double

Mid-infrared photometric W4-band (22 microns) saturated pixel fraction in the Vega system.

w4magOriginstring

Mid-infrared photometric W4-band (22 microns) catalog of origin in the Vega system (AL).

allWISEnaIndinteger

Active deblending indicator in AllWISE.

allWISEccIndstring

Contamination and confusion indicator in AllWISE.

allWISEphQualIndstring

Photometric quality indicator in AllWISE.

ps1ObjInfoFlaginteger

Object information flag in Pan-STARRS.

ps1QualityFlaginteger

Quality flag in Pan-STARRS.

ps1astrometryCorrectionFlaginteger

Astrometry correction flag in Pan-STARRS.

twoMassPHQualIndstring

Photometric (PH) quality indicator in 2MASS PSC.

twoMassReadFlagstring

Read flag in 2MASS PSC.

astrometricExcessNoisenumber double

Astrometric excess noise in the Gaia catalog measured in milliarcseconds.

astrometricExcessNoiseSignumber double

Astrometric excess noise sigma in Gaia.

ruwenumber double

RUWE in Gaia.

nonSingleStarstring

Identifier indicating the source is a non-single star in gaia (additional information is available in non-single star tables. Consumers should contact the provider for details on the specifications).

varFlagboolean

Flag indicating that the source exhibits variable magnitude.

variabilitystring

Identifier indicating variability is present in the photometric data. Consumers should contact the provider for details on the specifications.

multFlagboolean

Flag indicating that this is a multiple object source.

multiplicitystring

Identifier indicating multiplicity is detected. Consumers should contact the provider for details on the specifications.

morphologyIndinteger

Morphology indicator. Consumers should contact the provider for details on the specifications.

neighborIdinteger

The catalog ID of the nearest neighbor to this source.

neighborFlagboolean

Flag indicating that the nearest catalog neighbor is closer than 4.6 arcseconds.

neighborDistancenumber double

Distance between source and nearest neighbor, in arcseconds.

neighborRanumber double

RA of nearest neighbor measured in degrees.

neighborDecnumber double

Dec of nearest neighbor measured in degrees.

numNeighborsinteger

Number of neighbors.

shiftFlagboolean

Flag indicating that the photocentric shift is greater than 50 milliarcseconds.

shiftnumber double

Photocentric shift caused by neighbors, in arcseconds.

shiftFWHM1number double

Photocentric shift caused by neighbors, in arcseconds. This value is constrained to a Point Spread Function (PSF) with Full Width at Half Maximum (FWHM) of one arcsecond.

shiftFWHM6number double

Photocentric shift caused by neighbors, in arcseconds. This value is constrained to a Point Spread Function (PSF) with Full Width at Half Maximum (FWHM) of six arcseconds.

createdAtstring date-time

Time the row was created in the database, auto-populated by the system.

createdBystring

Application user who created the row in the database, auto-populated by the system.

updatedAtstring date-time

Time the row was last updated in the database, auto-populated by the system.

updatedBystring

Application user who updated the row in the database, auto-populated by the system.

sourcestring required

Source of the data.

originstring

Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.

origNetworkstring

The originating source network on which this record was created, auto-populated by the system.

dataMode'REAL' | 'TEST' | 'EXERCISE' | 'SIMULATED' required

Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data:

REAL: Data collected or produced that pertains to real-world objects, events, and analysis.

TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics.

EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data.

SIMULATED: Synthetic data generated by a model to mimic real-world datasets.

Example response

[
  {
    "id": "STAR-CAT-DATASET-ID",
    "classificationMarking": "U",
    "csId": 12345,
    "gncCatId": 12345,
    "sdaCatId": 3015023687,
    "gaiadr3CatId": 89012345678901,
    "hipCatId": 12345,
    "twoMASSId": "A1B2C3D4E5",
    "allWISEId": "WISEA J152743.04+624823.6",
    "panStarrsId": 215993386231483000,
    "ukidssLASId": 433883403451,
    "vhsId": 473820608583,
    "aavsoVsxId": 2387137,
    "tychoDscId": 9537000661,
    "twoMassXscId": "5000540",
    "ukidssGPSId": 439491265503,
    "wdsCatId": "155506",
    "carrascoCatId": 1244,
    "ducatiCatId": "AB ORI",
    "apassId": "175-0082419",
    "skyMapperId": 505176683,
    "uhsId": 460074663768,
    "catWise2020Id": "3584p196_b0-084425",
    "ukidssGCSId": 442466709194,
    "healpixIndex": 196607,
    "catVersion": "1.23 DR3",
    "ra": 14.43,
    "raUnc": 509.466,
    "dec": 21.8,
    "decUnc": 40.996,
    "parallax": -6.8,
    "parallaxUnc": 82.35,
    "pmra": 1000.45,
    "pmraUnc": 5.6,
    "pmdec": -970.1003,
    "pmdecUnc": 1.22,
    "astrometryOrigin": "GA",
    "starEpoch": 2018.864,
    "gmag": 0.0046,
    "gmagUnc": 0.00292,
    "bpmag": 0.04559,
    "bpmagUnc": 0.2227,
    "rpmag": 8.0047,
    "rpmagUnc": 1.233,
    "sgmag": 28.663515,
    "sgmagUnc": 2.3097522,
    "bmag": 27.004,
    "bmagUnc": 9.999,
    "bmagOrigin": "AP",
    "vmag": 25.829414,
    "vmagUnc": 2.055,
    "vmagOrigin": "CR",
    "rmag": 22.657284,
    "rmagUnc": 0.053,
    "rmagOrigin": "GA",
    "imag": 22.46249,
    "imagUnc": 1.2000417,
    "imagOrigin": "HI",
    "abgmag": 11.24,
    "abgmagUnc": 0.023,
    "abgmagOrigin": "PS",
    "abrmag": 11.24,
    "abrmagUnc": 0.023,
    "abrmagOrigin": "SK",
    "abimag": 11.24,
    "abimagUnc": 0.023,
    "abimagOrigin": "GA",
    "abzmag": 11.24,
    "abzmagUnc": 0.023,
    "abzmagOrigin": "AP",
    "abymag": 11.24,
    "abymagUnc": 0.023,
    "abymagOrigin": "AP",
    "jmag": 9.515,
    "jmagUnc": 7.559,
    "jmagOrigin": "TP",
    "kmag": 13.545,
    "kmagUnc": 0.052,
    "kmagOrigin": "UC",
    "hmag": 12.126,
    "hmagUnc": 5.722,
    "hmagOrigin": "UL",
    "w1mag": 15.782,
    "w1magUnc": 0.042,
    "w1sat": 0.993,
    "w1magOrigin": "CA",
    "w2mag": 16.523,
    "w2magUnc": 0.021,
    "w2sat": 0.962,
    "w2magOrigin": "CA",
    "w3mag": 11.541,
    "w3magUnc": 0.159,
    "w3sat": 0.999,
    "w3magOrigin": "AL",
    "w4mag": 9.007,
    "w4magUnc": 0.468,
    "w4sat": 0.523,
    "w4magOrigin": "AL",
    "allWISEnaInd": 1,
    "allWISEccInd": "0000",
    "allWISEphQualInd": "AAAA",
    "ps1ObjInfoFlag": 2005196800,
    "ps1QualityFlag": 239,
    "ps1astrometryCorrectionFlag": 7,
    "twoMassPHQualInd": "AAAA",
    "twoMassReadFlag": "111",
    "astrometricExcessNoise": 921.2857,
    "astrometricExcessNoiseSig": 194326670.1,
    "ruwe": 116.016365,
    "nonSingleStar": "7",
    "varFlag": true,
    "variability": "1",
    "multFlag": true,
    "multiplicity": "2",
    "morphologyInd": 5,
    "neighborId": 2456,
    "neighborDistance": 201.406,
    "neighborRa": 359.99,
    "neighborDec": 89.99,
    "numNeighbors": 519,
    "shift": 4.548,
    "shiftFWHM1": 0.157,
    "shiftFWHM6": 1.065,
    "createdAt": "2018-01-01T16:00:00.123Z",
    "createdBy": "some.user",
    "updatedAt": "2018-01-01T16:00:00.123Z",
    "updatedBy": "some.user",
    "source": "Bluestaq",
    "origin": "THIRD_PARTY_DATASOURCE",
    "origNetwork": "OPS1",
    "dataMode": "TEST"
  }
]

Changes

  • bd17bc53681eRevision changes
    • breaking

      the / response's property format changed from int32 to int64 for status

  • 173e4aff893fRevision changes
    • breaking

      the / response property's maxLength was increased from 32 to 36 for the response status

    • breaking

      the / response property's maxLength was increased from 36 to 64 for the response status

    • breaking

      the / response property's maxLength was increased from 32 to 36 for the response status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      the response optional property / became read-only for the status

    • info

      removed the GAIADR3 enum value from the / response property for the response status

    • info

      removed the HIPPARCOS enum value from the / response property for the response status

    • info

      removed the USNOBSC enum value from the / response property for the response status

Some revisions have not been checked yet.