> ## Documentation Index > Fetch the complete documentation index at: https://docs.nebyoulous.space/llms.txt > Use this file to discover all available pages before exploring further. # List deep-sky objects above a minimum altitude. ## OpenAPI ````yaml /api-reference/openapi.json get /dso/visible openapi: 3.0.3 info: title: Nebyoulous API description: >- REST API behind the Nebyoulous web app, CLI, and MCP server. Requests that act on your data need a bearer token. version: 0.0.0 servers: - url: https://api.nebyoulous.space description: Production security: [] tags: - name: System description: Service health. - name: Account description: The signed-in user and their profile. - name: Integration sets description: Sets of frames for one target. - name: Uploads description: Presigned uploads into an integration set. - name: Assets description: Download, view, preview, and delete uploaded files. - name: Stacking and analysis description: >- Stack jobs, frame analysis, and frame QA. All run asynchronously: submit, then poll. - name: Exports description: Export an integration set as an archive. - name: Gear and rigs description: Equipment items and the rigs built from them. - name: Planner description: Nightly scores, saved locations, and sessions. - name: Catalog description: The deep-sky object catalog. - name: Light pollution description: Sky brightness for a location. - name: Posts description: Your drafts and published posts. - name: Public posts description: Published posts anyone can read. - name: Comments and annotations description: Threads and replies on published posts. - name: Mentions description: Mentions of you in comments. - name: Advisor usage description: Your advisor usage ledger. paths: /dso/visible: get: tags: - Catalog summary: List deep-sky objects above a minimum altitude. parameters: - schema: type: number minimum: -90 maximum: 90 in: query name: lat required: true - schema: type: number minimum: -180 maximum: 180 in: query name: lng required: true - schema: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ in: query name: date required: true - schema: default: 30 type: number minimum: 0 maximum: 90 in: query name: min_alt required: false - schema: default: 50 type: integer minimum: 1 maximum: 200 in: query name: limit required: false - schema: default: 0 type: integer minimum: 0 maximum: 9007199254740991 in: query name: offset required: false responses: '200': description: Default Response content: application/json: schema: type: object properties: objects: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ catalogId: type: string name: type: string commonName: nullable: true type: string displayName: type: string type: type: string enum: - galaxy - nebula - open_cluster - globular_cluster - planetary_nebula - dark_nebula - galaxy_cluster - supernova_remnant - double_star - other ra: type: number dec: type: number magnitude: nullable: true type: number sizeArcmin: nullable: true type: number sizeMajor: nullable: true type: number sizeMinor: nullable: true type: number constellation: nullable: true type: string source: type: string enum: - catalog_import - manual - user_submission sourceCatalog: nullable: true type: string enum: - NGC - IC - M - C - UGC - PGC - Abell - Barnard - Lynds importBatchId: nullable: true type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ createdBy: nullable: true type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ notes: nullable: true type: string archivedAt: nullable: true type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ description: nullable: true type: string imagingNotes: nullable: true type: string designations: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ catalog: type: string enum: - NGC - IC - M - C - UGC - PGC - Abell - Barnard - Lynds designation: type: string required: - id - catalog - designation additionalProperties: false createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ altitude: type: number required: - id - catalogId - name - commonName - displayName - type - ra - dec - magnitude - sizeArcmin - sizeMajor - sizeMinor - constellation - source - sourceCatalog - importBatchId - createdBy - notes - archivedAt - description - imagingNotes - designations - createdAt - updatedAt - altitude additionalProperties: false page: type: object properties: total: type: integer minimum: 0 maximum: 9007199254740991 limit: type: integer exclusiveMinimum: true maximum: 9007199254740991 offset: type: integer minimum: 0 maximum: 9007199254740991 hasMore: type: boolean required: - total - limit - offset - hasMore additionalProperties: false required: - objects - page additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- An access token issued by a Nebyoulous sign-in: the web session, `nebyoulous login`, or an MCP OAuth grant. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.