> ## Documentation Index > Fetch the complete documentation index at: https://docs-v2.sortx.co.uk/llms.txt > Use this file to discover all available pages before exploring further. # Epc planner shared > A landlord's EPC planner, read only, by signed link ## OpenAPI ````yaml /openapi.json get /p/:tenant/epc-planner/{token} openapi: 3.1.0 info: title: SortX API version: 1.0.0 description: >- Reactive repairs, planned maintenance, compliance and the repairs desk for UK letting agents and property managers. servers: - url: https://api.sortx.co.uk description: Production security: [] tags: - name: tenants - name: entitlements - name: events - name: workspace-settings - name: operational-catalogues - name: money - name: contacts - name: properties - name: address-lookup - name: tenancies - name: contractor-invoices - name: keys - name: inspections - name: handovers - name: planned-maintenance - name: contractors - name: documents - name: compliance - name: activity - name: tasks - name: today - name: reports - name: workspace-search - name: calendar - name: telephony - name: maintenance-pro - name: front-desk - name: maintenance-pro-public - name: maintenance-pro-contractor paths: /p/:tenant/epc-planner/{token}: get: tags: - maintenance-pro-public summary: Epc planner shared description: A landlord's EPC planner, read only, by signed link operationId: maintenance-pro-public.epcPlannerShared parameters: - name: token in: path schema: type: string required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EpcPlannerSharedView' '400': description: >- TenantCreateRejected | ConfigMissing | IntegrationRejected | AuthRejected | RegistrationRejected | UnknownIntegration | WebhookUnroutable | RateUnavailable content: application/json: schema: anyOf: - $ref: '#/components/schemas/TenantCreateRejectedEncoded' - $ref: '#/components/schemas/ConfigMissingEncoded' - $ref: '#/components/schemas/IntegrationRejectedEncoded' - $ref: '#/components/schemas/AuthRejectedEncoded' - $ref: '#/components/schemas/RegistrationRejectedEncoded' - $ref: '#/components/schemas/UnknownIntegrationEncoded' - $ref: '#/components/schemas/WebhookUnroutableEncoded' - $ref: '#/components/schemas/RateUnavailableEncoded' '401': description: Unauthenticated | WebhookRejected | ApiKeyRejected content: application/json: schema: anyOf: - $ref: '#/components/schemas/UnauthenticatedEncoded' - $ref: '#/components/schemas/WebhookRejectedEncoded' - $ref: '#/components/schemas/ApiKeyRejectedEncoded' '402': description: TenantSuspended content: application/json: schema: $ref: '#/components/schemas/TenantSuspendedEncoded' '403': description: >- EntitlementMissing | NotAMember | ScopeUnknown | ScopeMissing | TenantMismatch content: application/json: schema: anyOf: - $ref: '#/components/schemas/EntitlementMissingEncoded' - $ref: '#/components/schemas/NotAMemberEncoded' - $ref: '#/components/schemas/ScopeUnknownEncoded' - $ref: '#/components/schemas/ScopeMissingEncoded' - $ref: '#/components/schemas/TenantMismatchEncoded' '404': description: >- TenantNotFound | ModuleRequestNotFound | PublicResourceNotFound | EpcPlannerLinkNotFound content: application/json: schema: anyOf: - $ref: '#/components/schemas/TenantNotFoundEncoded' - $ref: '#/components/schemas/ModuleRequestNotFoundEncoded' - $ref: '#/components/schemas/PublicResourceNotFoundEncoded' - $ref: '#/components/schemas/EpcPlannerLinkNotFoundEncoded' '409': description: WebhookDuplicate | RegistrationConflict content: application/json: schema: anyOf: - $ref: '#/components/schemas/WebhookDuplicateEncoded' - $ref: '#/components/schemas/RegistrationConflictEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' '503': description: IntegrationUnavailable content: application/json: schema: $ref: '#/components/schemas/IntegrationUnavailableEncoded' security: [] components: schemas: EpcPlannerSharedView: type: object properties: agency: type: object properties: name: type: string phone: anyOf: - type: string - type: 'null' required: - name - phone additionalProperties: false landlordName: anyOf: - type: string - type: 'null' note: anyOf: - type: string - type: 'null' expiresAt: type: string timeZone: type: string today: type: string dataAsOf: type: string policyVersion: type: string items: type: array items: $ref: '#/components/schemas/EpcPlannerItem' summary: $ref: '#/components/schemas/EpcPlannerSummaryRow' required: - agency - landlordName - note - expiresAt - timeZone - today - dataAsOf - policyVersion - items - summary additionalProperties: false TenantCreateRejectedEncoded: type: object properties: _tag: type: string enum: - TenantCreateRejected reason: type: string field: anyOf: - type: string - type: 'null' required: - _tag - reason additionalProperties: false ConfigMissingEncoded: type: object properties: _tag: type: string enum: - ConfigMissing key: type: string required: - _tag - key additionalProperties: false IntegrationRejectedEncoded: type: object properties: _tag: type: string enum: - IntegrationRejected integration: type: string reason: type: string required: - _tag - integration - reason additionalProperties: false AuthRejectedEncoded: type: object properties: _tag: type: string enum: - AuthRejected code: type: string message: type: string required: - _tag - code - message additionalProperties: false RegistrationRejectedEncoded: type: object properties: _tag: type: string enum: - RegistrationRejected message: type: string field: anyOf: - type: string - type: 'null' required: - _tag - message additionalProperties: false UnknownIntegrationEncoded: type: object properties: _tag: type: string enum: - UnknownIntegration integration: type: string required: - _tag - integration additionalProperties: false WebhookUnroutableEncoded: type: object properties: _tag: type: string enum: - WebhookUnroutable integration: type: string reason: type: string required: - _tag - integration - reason additionalProperties: false RateUnavailableEncoded: type: object properties: _tag: type: string enum: - RateUnavailable base: type: string quote: type: string 'on': type: string required: - _tag - base - quote - 'on' additionalProperties: false UnauthenticatedEncoded: type: object properties: _tag: type: string enum: - Unauthenticated required: - _tag additionalProperties: false WebhookRejectedEncoded: type: object properties: _tag: type: string enum: - WebhookRejected integration: type: string reason: type: string required: - _tag - integration - reason additionalProperties: false ApiKeyRejectedEncoded: type: object properties: _tag: type: string enum: - ApiKeyRejected required: - _tag additionalProperties: false TenantSuspendedEncoded: type: object properties: _tag: type: string enum: - TenantSuspended tenantId: type: string reason: type: string required: - _tag - tenantId - reason additionalProperties: false EntitlementMissingEncoded: type: object properties: _tag: type: string enum: - EntitlementMissing tenantId: type: string moduleId: type: string required: - _tag - tenantId - moduleId additionalProperties: false NotAMemberEncoded: type: object properties: _tag: type: string enum: - NotAMember userId: type: string slug: type: string required: - _tag - userId - slug additionalProperties: false ScopeUnknownEncoded: type: object properties: _tag: type: string enum: - ScopeUnknown scope: type: string required: - _tag - scope additionalProperties: false ScopeMissingEncoded: type: object properties: _tag: type: string enum: - ScopeMissing scope: type: string required: - _tag - scope additionalProperties: false TenantMismatchEncoded: type: object properties: _tag: type: string enum: - TenantMismatch header: type: string organizationId: type: string required: - _tag - header - organizationId additionalProperties: false TenantNotFoundEncoded: type: object properties: _tag: type: string enum: - TenantNotFound slug: type: string required: - _tag - slug additionalProperties: false ModuleRequestNotFoundEncoded: type: object properties: _tag: type: string enum: - ModuleRequestNotFound id: type: string required: - _tag - id additionalProperties: false PublicResourceNotFoundEncoded: type: object properties: _tag: type: string enum: - PublicResourceNotFound reason: type: string required: - _tag - reason additionalProperties: false EpcPlannerLinkNotFoundEncoded: type: object properties: _tag: type: string enum: - EpcPlannerLinkNotFound required: - _tag additionalProperties: false WebhookDuplicateEncoded: type: object properties: _tag: type: string enum: - WebhookDuplicate integration: type: string externalId: type: string required: - _tag - integration - externalId additionalProperties: false RegistrationConflictEncoded: type: object properties: _tag: type: string enum: - RegistrationConflict message: type: string field: anyOf: - type: string - type: 'null' required: - _tag - message additionalProperties: false RateLimitedEncoded: type: object properties: _tag: type: string enum: - RateLimited key: type: string retryAfterSeconds: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN message: type: string required: - _tag - key - retryAfterSeconds - message additionalProperties: false IntegrationUnavailableEncoded: type: object properties: _tag: type: string enum: - IntegrationUnavailable integration: type: string detail: anyOf: - type: string - type: 'null' required: - _tag - integration additionalProperties: false EpcPlannerItem: type: object properties: propertyId: type: string address: anyOf: - type: string - type: 'null' postcode: anyOf: - type: string - type: 'null' standing: type: string enum: - below_c - no_rating - no_epc - c_or_above rating: anyOf: - type: string enum: - A - B - C - D - E - F - G - type: 'null' bandsToC: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' certificate: anyOf: - type: object properties: documentId: type: string issuedOn: anyOf: - type: string - type: 'null' expiresOn: anyOf: - type: string - type: 'null' reference: anyOf: - type: string - type: 'null' required: - documentId - issuedOn - expiresOn - reference additionalProperties: false - type: 'null' expiredOn: anyOf: - type: string - type: 'null' measures: type: array items: $ref: '#/components/schemas/EpcMeasureRow' measuresSource: anyOf: - type: string enum: - read - not_listed - unreadable - no_file - type: 'null' potentialRating: anyOf: - type: string enum: - A - B - C - D - E - F - G - type: 'null' toC: anyOf: - type: object properties: steps: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN costLowMinor: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' costHighMinor: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' basis: type: string enum: - steps - all required: - steps - costLowMinor - costHighMinor - basis additionalProperties: false - type: 'null' dates: type: array items: type: object properties: 'on': type: string kind: type: string enum: - epc_expires - counts_until - cut_off - standard label: type: string required: - 'on' - kind - label additionalProperties: false required: - propertyId - address - postcode - standing - rating - bandsToC - certificate - expiredOn - measures - measuresSource - potentialRating - toC - dates additionalProperties: false EpcPlannerSummaryRow: type: object properties: properties: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN belowC: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN cOrAbove: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN noRating: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN noEpc: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN indicativeToC: anyOf: - type: object properties: costLowMinor: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN costHighMinor: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN properties: anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN required: - costLowMinor - costHighMinor - properties additionalProperties: false - type: 'null' required: - properties - belowC - cOrAbove - noRating - noEpc - indicativeToC additionalProperties: false EpcMeasureRow: type: object properties: measure: type: string costLowMinor: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' costHighMinor: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' ratingAfter: anyOf: - type: string enum: - A - B - C - D - E - F - G - type: 'null' scoreAfter: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' required: - measure - costLowMinor - costHighMinor - ratingAfter - scoreAfter additionalProperties: false ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.